رموز الخطأ
هذه الصفحة هي المرجع الأساسي لمعالجة الأخطاء. رموز الأخطاء الخاصة بكل SDK موثقة في صفحة معالجة الأخطاء لكل SDK؛ وتغطي هذه الصفحة الأخطاء على مستوى عقد API.
رموز حالة HTTP
| الرمز | المعنى |
|---|---|
200 OK | نجح الطلب. |
400 Bad Request | الحمولة مشوّهة أو الحقول المطلوبة مفقودة. يُحدد النص الحقول المسبِّبة للمشكلة. |
401 Unauthorized | المصادقة مفقودة أو منتهية الصلاحية أو غير صالحة. |
403 Forbidden | المصادقة صالحة لكن المستأجر غير مُمكَّن للمورد المطلوب (مثلًا، استدعاء قدرة غير موجودة في APIKEY الخاص بك). |
404 Not Found | المورد غير موجود أو لا ينتمي إلى المستأجر المصا دَق عليه. |
409 Conflict | المورد موجود لكنه ليس في الحالة الصحيحة لهذه العملية (مثلًا، جلب مستندات من عملية لا تزال قيد التقدم). |
410 Gone | المورد كان موجودًا لكن تم حذفه وفق سياسة الاحتفاظ (نقاط نهاية جلب المستندات)، أو العملية موجودة لكنها انتهت في حالة خطأ — انظر الحصول على العملية. |
429 Too Many Requests | تجاوزت حد المعدل. أعد المحاولة بتراجع أسي. |
5xx | خطأ في المنصة. أعد المحاولة بتراجع؛ وإذا استمرت المشكلة، تواصل مع الدعم مع نص الاستجابة والطابع الزمني. |
سياسة إعادة المحاولة
| الحالة | هل تُعاد المحاولة؟ | الطريقة |
|---|---|---|
5xx | نعم | تراجع أسي (1 ثانية، 2 ثانية، 4 ثوانٍ، 8 ثوانٍ، …). حد أقصى 5 محاولات. |
429 | نعم | احترم ترويسة Retry-After إن وُجدت؛ وإلا استخدم التراجع الأسي. |
4xx (أخرى) | لا | الطلب خاطئ. صحح المدخلات قبل إعادة المحاولة. |
401 | مشروط | جدد رمز الوصول مرة واحدة. إذا أعاد الطلب الجديد 401 أيضًا، فالمشكلة هيكلية — لا تعد المحاولة. |
Idempotency
لا تُوفر منصة IDCloud حاليًا آلية مفتاح أمانة (idempotency-key) على نقاط نهاية الإنشاء. توخَّ الحذر عند إعادة محاولة إنشاء عملية — قد يكون خطأ الشبكة على 5xx قد نجح فعليًا من جهة الخادم، وقد تُنشئ إعادة المحاولة عملية مكررة. عند الشك، استرجع العمليات الأخيرة بمعرف الارتباط الداخلي قبل إعادة المحاولة.
أين توجد أخطاء SDK
كتالوجات الأخطاء الخاصة بـ Android SDK و iOS SDK و Flutter SDK موثقة في صفحة معالجة الأخطاء المخصصة لكل SDK:
تغطي هذه الصفحات أخطاء جانب الجهاز (رفض إذن الكاميرا، انتهاء مهلة الالتقاط، الشبكة غير متوفرة على الجهاز) — بشكل منفصل عن أخطاء جانب API الموثقة هنا.