رموز الاستجابة للحالة

يمكن عرض رموز الحالة التالية في استجابات 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 انتهاء مهلة البوابة انتهت صلاحية الموعد النهائي قبل اكتمال العملية. بالنسبة إلى العمليات التي تغيّر حالة النظام، قد يظهر هذا الخطأ حتى إذا اكتملت العملية بنجاح. على سبيل المثال، قد يتأخر الرد الناجح من الخادم لفترة كافية حتى تنتهي صلاحية الموعد النهائي.

في بعض الأحيان، قد تنطبق عدة رموز خطأ. يجب أن تعرض الخدمات رمز الخطأ الأكثر تحديدًا المناسب.