رموز حالة HTTP

كيف يعمل

معظم رموز الحالة واضحة، وقلة منها مربكة فعلًا، خصوصًا تلك المتشابهة في المعنى. اكتب رقمًا، أو كلمة مثل forbidden، أو 4xx لعرض فئة كاملة.

401 و403، الثنائي الذي يخلط الجميع بينهما

يعني 401 Unauthorized في الواقع أن المستخدم غير مصادَق: الخادم لا يعرف من أنت، وقد يحل المشكلة إرسال بيانات الاعتماد. ويعني 403 Forbidden أنه يعرف تمامًا من أنت ومع ذلك لا يُسمح لك. الاسمان تاريخيان وغير مفيدين؛ لكن التمييز مهم لأن أحدهما يدعو إلى تسجيل الدخول والآخر لا.

301 مقابل 302، ولماذا يهم ذلك لتحسين محركات البحث

301 دائم وينقل إشارات الترتيب إلى العنوان الجديد. 302 مؤقت ويتركها على العنوان الأصلي. استخدام 302 لنقل دائم خطأ شائع وكلفته خفية. أما 307 و308 فهما المكافئان الحديثان اللذان يضمنان إضافة إلى ذلك عدم تغيير الطريقة، فيبقى POST هو POST، وهو ما لم يكن 301 و302 يفعلانه تاريخيًا.

422 للتحقق من الصحة

يعني 400 Bad Request أن الخادم لم يستطع فهم الطلب على الإطلاق. ويعني 422 Unprocessable Content أنه فهمه تمامًا لكن المحتوى خاطئ، كحقل ناقص أو بريد إلكتروني غير صالح. ينبغي لمعظم واجهات API إعادة 422 عند فشل التحقق، لكنها تعيد 400 بحكم العادة.

الفئات

1xx معلوماتية، 2xx نجاح، 3xx إعادة توجيه، 4xx خطأ العميل، 5xx خطأ الخادم. وهذا التقسيم الأخير هو ما تلجأ إليه عند تحديد المسؤولية في حادثة: ارتفاع مفاجئ في 4xx يعني أن المستدعين يفعلون شيئًا خاطئًا، وارتفاع مفاجئ في 5xx يعني أنك أنت المخطئ.

418

I'm a teapot، من مزحة الأول من أبريل عام 1998، ثم اعتُمد لاحقًا بجدية بعد أن أثارت محاولة إزالته من التطبيقات احتجاجًا واسعًا. وهو ليس للاستخدام الفعلي، لكنه جزء حقيقي من المواصفة.