الأخطاء والثبات

تستخدم الأخطاء application/problem+json وحالة HTTP الحقيقية وrequest_id.

يتطلب الإنشاء Idempotency-Key من 8–128 حرفًا. يُخزن HMAC وبصمة الطلب فقط. المفتاح والجسم نفسيهما يعيدان المهمة الأصلية؛ جسم مختلف يعيد 409 idempotency_conflict؛ والطلب الجاري يعيد 409 request_in_progress. لا تنشئ مفتاحًا جديدًا في إعادة المحاولة الآلية.

الرموز الشائعة: invalid_api_key وinvalid_api_key_rate_limited وapi_key_expired وinsufficient_scope وvalidation_error وunsupported_model وunsupported_parameter وinput_url_not_allowed وinsufficient_credits وpayment_required وaccount_suspended وnetwork_not_allowed وrate_limit_exceeded وconcurrency_limit_exceeded وprovider_unavailable وservice_unavailable.

تُحد الطلبات ذات بيانات اعتماد غير صالحة المتكررة من IP نفسه، ولا تُخزن إلا بصمة IP محمية بـPepper HMAC.

أعد أخطاء الشبكة و429 و503 بتراجع والجسم والمفتاح نفسيهما. إذا تعذر تأكيد نتيجة Provider ترفض الواجهة الإرسال الأعمى.

التزم دائمًا بالـheader ‏Retry-After قبل إعادة المحاولة.