الغلاف
تُرجِع Infrastructure API:دائمًا تشعَّب بناءً على رمز حالة HTTP. قد تتطور أسماء الحقول داخل الجسم؛
أما رموز الحالة فهي مستقرة.
رموز الحالة
ما الذي ينبغي إعادة محاولته
مخطّط للتراجع
أخطاء شائعة
401 Unauthorized
403 Forbidden
429 Too Many Requests
تتضمن الاستجابة رأس Retry-After بالثواني التي ينبغي الانتظار قبل
إعادة المحاولة. توقّف لما لا يقل عن تلك المدة قبل المحاولة من جديد.
503 Service Unavailable
الشبكة المتراصة أو إحدى التبعيات الأمامية متدهورة. تم تصميم Coordination
API للاستمرار في العمل في هذه الحالة — يحفظ استيعاب القياس عن بُعد
محليًا على الحافة ويُعيد المحاولة. ينبغي لطلبات العميل ذات
الـ idempotency أن تُعيد المحاولة مع تراجع.
الإبلاغ عن خطأ
إذا واجهت إخفاقًا قابلاً للتكرار لا يطابق هذا المرجع، افتح issue على مستودع الوثائق مع:- طريقة HTTP، والمسار، ورمز الحالة
- Request ID (رأس الاستجابة
X-Request-Id) إن وُجد - نسخة منقَّحة من جسم الطلب
- الجسم الكامل للاستجابة