Skip to main content
تستخدم كلتا واجهتي ResQ رموز حالة HTTP القياسية، وتُرجِع غلاف JSON صغيرًا عند الفشل. تعامَل مع رمز الحالة على أنه المرجع؛ وتعامَل مع الجسم على أنه تفاصيل تشخيصية للسجلات وواجهات المشغّل — وليس للتحكم بالتدفق.

الغلاف

تُرجِع Infrastructure API:
تُرجِع Coordination API نفس الشكل، أو غلافًا أكثر ثراءً على نقاط النهاية التي تُبلِّغ عن إخفاقات متعددة:
دائمًا تشعَّب بناءً على رمز حالة HTTP. قد تتطور أسماء الحقول داخل الجسم؛ أما رموز الحالة فهي مستقرة.

رموز الحالة

ما الذي ينبغي إعادة محاولته

مخطّط للتراجع

أخطاء شائعة

401 Unauthorized

أعد تشغيل تدفق تسجيل الدخول الموصوف في المصادقة ثم أعد المحاولة مرة واحدة.

403 Forbidden

المشغّل مُصادَق لكنه لا يمتلك نطاق الصلاحية المطلوب. اعرض هذا للمستخدم؛ ولا تُعد المحاولة. تتطلب تدفقات الموافقة على المهام تحديدًا مشغّلين مُخوَّلين عبر HITL (المادة 14 من قانون الذكاء الاصطناعي الأوروبي).

429 Too Many Requests

تتضمن الاستجابة رأس Retry-After بالثواني التي ينبغي الانتظار قبل إعادة المحاولة. توقّف لما لا يقل عن تلك المدة قبل المحاولة من جديد.

503 Service Unavailable

الشبكة المتراصة أو إحدى التبعيات الأمامية متدهورة. تم تصميم Coordination API للاستمرار في العمل في هذه الحالة — يحفظ استيعاب القياس عن بُعد محليًا على الحافة ويُعيد المحاولة. ينبغي لطلبات العميل ذات الـ idempotency أن تُعيد المحاولة مع تراجع.

الإبلاغ عن خطأ

إذا واجهت إخفاقًا قابلاً للتكرار لا يطابق هذا المرجع، افتح issue على مستودع الوثائق مع:
  • طريقة HTTP، والمسار، ورمز الحالة
  • Request ID (رأس الاستجابة X-Request-Id) إن وُجد
  • نسخة منقَّحة من جسم الطلب
  • الجسم الكامل للاستجابة