قراءة الاستجابة كاملة
عند حالة غير ناجحة، احتفظ برمز HTTP والترويسات ونص الخطأ ومعرّف الطلب بعد إزالة الأسرار. فهي تميّز الطلب غير الصالح عن رفض الوصول أو المشكلة المؤقتة.
لا تعرض استجابة خدمة خام باعتبارها رسالة المستخدم الوحيدة: اشرح الإجراء مع الاحتفاظ بالتفاصيل التشخيصية للمشغّل.
فحص استجابة فاشلة
bash
curl --include --request POST https://cicora.ai/api/v1/chat/completions \
--header "Authorization: Bearer $CICORA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{"model":"openai/gpt-5.6-sol","messages":[]}'تصنيف العطل
- تتطلب 4xx عادةً تصحيح المفتاح أو بيانات الإدخال أو الوصول.
- يتطلب 429 احترام نافذة الحد وتجنب إعادة المحاولة المكثّفة.
- تستدعي أعطال 5xx والشبكة إعادة محاولات محدودة مع تراجع أُسّي وعشوائية زمنية.
إعادة المحاولة بأمان
أعد محاولة الأعطال المؤقتة فقط، وفقط إذا كانت العملية في منتجك لا يتكرر أثرها عند إعادتها. عند الإنشاء، احتفظ بمعرّف طلب من العميل لمنع خصم مزدوج أو عنصر مكرر.
في البث، ميّز بين خطأ يقع قبل أول دلتا وانقطاع بعد مخرجات جزئية؛ فلا يمكن استبدال الحالة الثانية بصمت باستجابة جديدة.