--- title: رموز الخطأ description: كتالوج موحّد لرموز أخطاء HTTP والمنصة عبر عقود Web & SDK وAPI وMagic Link. canonical: https://developer.unico.io/ar/developers/start/error-codes locale: ar generated_by: markdown-export --- - [/ar/](/ar/) - [البداية](/ar/developers/start/) - رموز الخطأ **في هذه الصفحة# رموز الخطأ هذه الصفحة هي المرجع الأساسي لمعالجة الأخطاء. رموز الأخطاء الخاصة بكل SDK موثقة في صفحة معالجة الأخطاء لكل SDK؛ وتغطي هذه الصفحة الأخطاء على مستوى عقد API. ### رموز حالة HTTP​ الرمزالمعنى`200 OK`نجح الطلب.`400 Bad Request`الحمولة مشوّهة أو الحقول المطلوبة مفقودة. يُحدد النص الحقول المسبِّبة للمشكلة.`401 Unauthorized`المصادقة مفقودة أو منتهية الصلاحية أو غير صالحة.`403 Forbidden`المصادقة صالحة لكن المستأجر غير مُمكَّن للمورد المطلوب (مثلًا، استدعاء قدرة غير موجودة في `APIKEY` الخاص بك).`404 Not Found`المورد غير موجود أو لا ينتمي إلى المستأجر المصادَق عليه.`409 Conflict`المورد موجود لكنه ليس في الحالة الصحيحة لهذه العملية (مثلًا، جلب مستندات من عملية لا تزال قيد التقدم).`410 Gone`المورد كان موجودًا لكن تم حذفه وفق سياسة الاحتفاظ (نقاط نهاية جلب المستندات)، أو العملية موجودة لكنها انتهت في حالة خطأ — انظر [الحصول على العملية](/ar/developers/api-reference/get-process).`429 Too Many Requests`تجاوزت [حد المعدل](/ar/developers/start/rate-limits). أعد المحاولة بتراجع أسي.`5xx`خطأ في المنصة. أعد المحاولة بتراجع؛ وإذا استمرت المشكلة، تواصل مع الدعم مع نص الاستجابة والطابع الزمني. ### سياسة إعادة المحاولة​ الحالةهل تُعاد المحاولة؟الطريقة`5xx`نعمتراجع أسي (1 ثانية، 2 ثانية، 4 ثوانٍ، 8 ثوانٍ، …). حد أقصى 5 محاولات.`429`نعماحترم ترويسة `Retry-After` إن وُجدت؛ وإلا استخدم التراجع الأسي.`4xx` (أخرى)لاالطلب خاطئ. صحح المدخلات قبل إعادة المحاولة.`401`مشروطجدد رمز الوصول مرة واحدة. إذا أعاد الطلب الجديد `401` أيضًا، فالمشكلة هيكلية — لا تعد المحاولة. Idempotencyلا تُوفر منصة IDCloud حاليًا آلية مفتاح أمانة (idempotency-key) على نقاط نهاية الإنشاء. توخَّ الحذر عند إعادة محاولة [إنشاء عملية](/ar/developers/api-reference/post-processes) — قد يكون خطأ الشبكة على `5xx` قد نجح فعليًا من جهة الخادم، وقد تُنشئ إعادة المحاولة عملية مكررة. عند الشك، استرجع العمليات الأخيرة بمعرف الارتباط الداخلي قبل إعادة المحاولة. ### أين توجد أخطاء SDK​ كتالوجات الأخطاء الخاصة بـ Android SDK و iOS SDK و Flutter SDK موثقة في صفحة **معالجة الأخطاء** المخصصة لكل SDK: [Android SDK > معالجة الأخطاء](/ar/developers/sdks-and-tools/android/error-handling) [iOS SDK > معالجة الأخطاء](/ar/developers/sdks-and-tools/ios/error-handling) [Flutter SDK > معالجة الأخطاء](/ar/developers/sdks-and-tools/flutter/error-handling) تغطي هذه الصفحات أخطاء جانب الجهاز (رفض إذن الكاميرا، انتهاء مهلة الالتقاط، الشبكة غير متوفرة على الجهاز) — بشكل منفصل عن أخطاء جانب API الموثقة هنا.آخر تحديث في 8 أكتوبر 2026**