الانتقال إلى المحتوى الرئيسي
يبدأ رصد TokenLab الجيد بالمعرفات العامة. يجب أن تساعدك سجلاتك في الإجابة على “ما الذي طلبه المستخدم، وما هي المهمة العامة التي أنشأها TokenLab، وكيف تم الفوترة؟” دون الكشف عن تفاصيل توجيه المزود أو بيانات المستخدم الحساسة.

​
المعرفات العامة التي يجب التقاطها

المعرفمكان ظهورهاستخدمه لـ
request_idأجسام الأخطاء، سجلات لوحة التحكم، سجلات الاستخدامدعم على مستوى الطلب وتسوية
id / task_idاستجابات الإنشاء غير المتزامن والحالةاستعلام عن الصور، الفيديو، الموسيقى، والوظائف ثلاثية الأبعاد
poll_urlاستجابات الإنشاء غير المتزامنعنوان URL للحالة المفضلة
billing_transaction_idاستجابات غير متدفقة عند التسوية، استجابات حالة المهمة غير المتزامنة، سجلات الاستخدام، X-Billing-Transaction-IDتسوية التكلفة
X-Task-IDرؤوس استجابة المهمة غير المتزامنةارتباط المهمة على مستوى الرأس
معرف الوظيفة/المستخدم الخاص بكتطبيقكربط نشاط TokenLab بتدفق عمل المستخدم
لا تخزن معرفات مهام المزود، عناوين URL العلوية، معرفات قنوات التوجيه، مفاتيح Redis، أو بيانات التنفيذ الخاصة كحقائق موجهة للعملاء.

​
ما يجب تسجيله

سجل ما يكفي لتشخيص الطلب دون تسريب الأسرار:
  • نقطة النهاية، طريقة HTTP، النموذج، رمز الحالة، الطابع الزمني، والكمون.
  • المعرفات العامة: request_id، task_id، poll_url، و billing_transaction_id عند وجودها.
  • شكل الطلب المنقح: أي الحقول كانت موجودة، وليس النص الكامل أو محتوى الوسائط الخاصة.
  • استجابات الحالة غير المتزامنة النهائية، بما في ذلك حقول الخطأ العامة.
  • عدد محاولات إعادة الاتصال من العميل وما إذا كانت إعادة الاتصال قد أنشأت مهمة جديدة أو استأنفت واحدة موجودة.
قم دائمًا بحجب Authorization، مفاتيح API، رموز الإدارة، عناوين URL الموقعة، عناوين URL الوسائط الخاصة، النصوص الكاملة، وبيانات المستخدم الشخصية ما لم يكن لديك إذن صريح للاحتفاظ بها.

​
مصفوفة استكشاف الأخطاء

العرضتحقق أولاًصفحة مفيدة
401 أو 403مفتاح API، رمز الإدارة، وصول المؤسسة، نطاق المفتاحالمصادقة
402الرصيد، حد إنفاق مفتاح API، توفر سعر النموذجالفوترة والتسعير
429مستوى الحساب، حد معدل نقطة النهاية، سلوك إعادة المحاولةحدود المعدل
400 invalid_request_errorحقل غير مدعوم، نقطة نهاية خاطئة، حقل مطلوب مفقود، أو عدم تطابق عقد النموذجمعالجة الأخطاء
لا يمكن العثور على المهمة غير المتزامنةمفتاح API خاطئ، معرف مهمة قديم، مهمة منتهية، أو معرف مهمة غير عامالمهام غير المتزامنة والاستعلام
التكلفة لا تتطابق مع واجهة المستخدمتوقيت التسوية أو مقارنة المعرف الخاطئالفوترة والتسعير

​
تسوية الاستخدام

استخدم واجهة إدارة API للتسوية من جانب الخادم: 
curl "https://api.tokenlab.sh/v1/management/api-keys/key_abc123def456/usage?page=1&limit=20&scene=video" \
  -H "Authorization: Bearer mt-your-management-token"
GET /v1/management/api-keys/{keyId}/usage يمكن أن يقوم بالتصفية حسب scene، accessChannel، logicalModel، modelVendor، startDate، و endDate. استخدم هذه السجلات بدلاً من جمع بيانات صفحات لوحة التحكم أو الاعتماد على معرفات مهام المزود العلوية. قد تستقر الاستجابات المتدفقة بعد إرسال التدفق، لذا قد يكون رأس الفوترة غائبًا حتى عندما يتم تسجيل الاستخدام لاحقًا. قد تستقر المهام الإعلامية غير المتزامنة بعد الاستعلام النهائي.

​
قالب حزمة الدعم

عند الاتصال بالدعم، قم بتضمين:
  • request_id.
  • task_id و poll_url للعمل غير المتزامن.
  • billing_transaction_id عند وجوده.
  • نقطة النهاية، الطريقة، النموذج، الطابع الزمني، ورمز الحالة.
  • شكل الطلب المنقح وجسم الخطأ العام.
  • النتيجة المتوقعة وما رآه المستخدم فعليًا.
لا تتضمن مفاتيح API، رموز الإدارة، الوسائط الخاصة، النصوص الكاملة، عناوين URL للمزود، معرفات القنوات، أو المعرفات الداخلية للتوجيه ما لم يطلب دعم TokenLab صراحةً عينة محجوبة.

​
الفحوصات التشغيلية

  • تنبيه على تكرار الاستجابات 401، 402، 429، و 5xx بشكل منفصل؛ عادةً ما يكون لها مالكون مختلفون.
  • تتبع المهام غير المتزامنة التي تبقى غير نهائية لفترة أطول من SLA المنتج الخاص بك.
  • تتبع محاولات الإنشاء المكررة لنفس معرف وظيفة المستخدم.
  • عيّن عينة من الوظائف المكتملة وتحقق من أن الأصل المرئي للمستخدم، سجل الاستخدام، وسجل المهمة المخزنة تتفق.

​
مرجع API

الموضوعالمرجع
معالجة الأخطاءمعالجة الأخطاء
حدود المعدلحدود المعدل
الفوترة والتسعيرالفوترة والتسعير
الحصول على استخدام مفتاح APIالحصول على استخدام مفتاح API
الحصول على حالة المهمةالحصول على حالة المهمة