يمكن عرض رموز الحالة التالية في ردود HTTP.
رمز HTTP | وصف HTTP | ملاحظات |
---|---|---|
2xx | حسنًا | حدث خطأ، ولم يتم إرجاعها بنجاح. ويجب أيضًا استخدام هذه البيانات في حال عدم نجاح منطق الأنشطة التجارية
(على سبيل المثال، تعبئة booking_failure في
CreateBookingResponse
). |
400 | طلب سيئ | وسيطات الطلب غير صالحة/وسيطات غير صالحة (التاجر، الخدمة، الخانة غير موجودة، محاولة حجز خانة غير صالحة، وإلغاء الحجز الذي لم يكن موجودًا مطلقًا). |
401 | غير مصرح به | لم تتم مصادقتها (بيانات الاعتماد غير صالحة، أعِد محاولة تسجيل الدخول). لا يحتوي الطلب على بيانات اعتماد مصادقة صالحة للعملية. |
403 | محظور | تم رفض الإذن أو حظره (مع العلم أن المتصل تم رفضه). يجب عدم استخدام هذه الاستجابة لحالات الرفض الناتجة عن استنفاد بعض الموارد (استخدِم Too Many Requests بدلاً من هذه الأخطاء).
يجب عدم استخدام Forbidden في حال تعذّر تحديد المتصل (يمكنك استخدام Unauthorized بدلاً من هذه الأخطاء). |
404 | غير موجود | لم يتم العثور على المورد (لم يتم العثور على المورد، عنوان URL غير صالح، بما في ذلك وحدات التحكّم في حدود الجلسة (RPC) غير صالحة) |
409 | تعارض | تم إلغاء العملية، عادةً بسبب مشكلة في المزامنة، مثل تعذّر التحقّق من التسلسل أو إلغاء العملية. |
429 | عدد كبير جدًا من الطلبات | تم استنفاد بعض الموارد، أو قد تكون الحصة لكل مستخدم، أو نفدت مساحة التخزين في نظام الملفات بالكامل. |
499 | طلب العميل المغلق | تم إلغاء العملية، عادةً من قِبل المتصل. |
500 | خطأ في الخادم الداخلي | الأخطاء الداخلية وهذا يعني أن بعض الثوابت التي يتوقعها النظام الأساسي قد تعطّلت. يكون رمز الخطأ هذا محجوزًا للأخطاء الجسيمة. |
501 | لم يتم التنفيذ | العملية غير منفذة أو غير متاحة/مفعَّلة في هذه الخدمة. |
503 | الخدمة غير متوفرة | هذه الخدمة غير متاحة حاليًا. ومن المرجّح أن تكون هذه الحالة عابرة، ويمكن تصحيحها من خلال إعادة المحاولة باستخدام تراجع. |
504 | انتهاء مهلة البوابة | انتهت صلاحية الموعد النهائي قبل اكتمال العملية. بالنسبة إلى العمليات التي تغيّر حالة النظام، قد يتم عرض هذا الخطأ حتى إذا اكتملت العملية بنجاح. على سبيل المثال، يمكن أن تتأخر استجابة ناجحة من الخادم لفترة كافية كموعد انتهاء صلاحية. |
وقد تسري أحيانًا رموز خطأ متعددة. ويجب أن تعرض الخدمات رمز الخطأ الأكثر تحديدًا الذي ينطبق.