تنسيق استجابة الخطأ
عند وقوع خطأ، تُرجع API استجابة خطأ متسقة:رموز حالة HTTP
| رمز الحالة | الوصف |
|---|---|
200 | نجاح |
201 | تم الإنشاء |
204 | لا يوجد محتوى (حذف ناجح) |
400 | طلب غير صالح - معاملات غير صالحة |
401 | غير مصرَّح - بيانات اعتماد غير صالحة أو مفقودة |
403 | محظور - صلاحيات غير كافية |
404 | غير موجود - المورد غير موجود |
409 | تعارض - المورد موجود بالفعل |
422 | كيان لا يمكن معالجته - خطأ في التحقق |
429 | الكثير من الطلبات - تم تجاوز حد المعدل |
500 | خطأ داخلي في الخادم |
رموز الأخطاء الشائعة
أخطاء المصادقة
| الرمز | الوصف |
|---|---|
invalid_token | رمز الوصول غير صالح أو منتهي الصلاحية |
missing_token | لم يُقدَّم رأس authorization |
insufficient_scope | يفتقر الرمز إلى الصلاحيات المطلوبة |
أخطاء التحقق
| الرمز | الوصف |
|---|---|
invalid_request | جسم الطلب مشوَّه |
validation_error | فشل التحقق من حقل واحد أو أكثر |
missing_field | الحقل المطلوب مفقود |
أخطاء الموارد
| الرمز | الوصف |
|---|---|
not_found | المورد المطلوب غير موجود |
already_exists | المورد بهذا المعرّف موجود بالفعل |
conflict | العملية تتعارض مع الحالة الحالية |