تعامل مع أخطاء CometAPI من خلال تحديد ما إذا كان يجب إصلاح الطلب أو إعادة محاولته. أعد محاولةDocumentation Index
Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
Use this file to discover all available pages before exploring further.
429، والإخفاقات من فئة timeout، وإخفاقات الخادم المؤقتة باستخدام backoff؛ ولا تُعِد محاولة الطلبات غير الصحيحة أو إخفاقات المصادقة.
أعد المحاولة فقط مع الإخفاقات القابلة لإعادة المحاولة
| الحالة أو الإشارة | إعادة المحاولة؟ | الإجراء |
|---|---|---|
400 | لا | أصلح نص الطلب أو المعلمات. |
401 | لا | أصلح مفتاح API وترويسة Authorization. |
403 | غالبًا لا | أزل الحقول غير المدعومة وتحقق من إمكانية الوصول إلى model. |
429 | نعم | أعد المحاولة باستخدام exponential backoff وjitter. |
500 with invalid_request | لا | أصلح شكل الطلب. |
500, 503, 504, 524 | نعم | أعد المحاولة باستخدام backoff واحتفظ بـ request ID. |
أضف backoff
يوضح مثال Python التالي إعادة المحاولة فقط مع الإخفاقات القابلة لإعادة المحاولة:سجّل سياقًا مفيدًا
يكون شكل JSON التالي آمنًا للتخزين بعد إزالة أسرار المستخدم والملفات الكبيرة:الأخطاء الشائعة
| الخطأ | الإصلاح |
|---|---|
إعادة محاولة 401 | أوقف إعادة المحاولة وبدّل مفتاح API أو أعد تحميله. |
| إعادة محاولة JSON غير صالح | تحقّق من نص الطلب قبل إرسال طلب آخر. |
| عدم وجود request ID في السجلات | التقط نص الخطأ الكامل قبل أن يقوم SDK بتغليفه. |
إعادة المحاولة فورًا بعد 429 | أضف jitter وقلّل التزامن. |