رموز حالة HTTP

شرح مبسّط لكل رموز حالة HTTP: ماذا يعني الرمز، وأسبابه الشائعة، وكيفية إصلاحه، ومثال على الاستجابة، والمعيار RFC الذي يعرّفه.

70 رمز حالة

1xx معلوماتية

استجابات مؤقتة: استُلم الطلب وتستمر معالجته.

100 Continue استمر استلم الخادم ترويسات الطلب ويمكن للعميل إرسال جسم الطلب. هذه استجابة مؤقتة تُرسل قبل الحالة النهائية. 101 Switching Protocols تبديل البروتوكول يوافق الخادم على التحول إلى البروتوكول الذي طلبه العميل في ترويسة Upgrade، وغالبًا ما يكون WebSocket. بعد هذه الاستجابة يستخدم الاتصال البروتوكول الجديد. 102 Processing قيد المعالجة استجابة مؤقتة في WebDAV تخبر العميل بأن الخادم ما زال يعمل على طلب طويل، فلا ينبغي أن تنتهي مهلته بعد. هذا الرمز مهجور ونادرًا ما يُرسل اليوم. 103 Early Hints تلميحات مبكرة استجابة مؤقتة ترسل ترويسات Link مبكرًا ليتمكن المتصفح من التحميل المسبق لملفات CSS والخطوط أو الاتصال المسبق بالمصادر بينما لا يزال الخادم يبني الصفحة النهائية.

2xx نجاح

استُلم الطلب وفُهم وقُبل.

200 OK حسنًا نجح الطلب. في GET يحتوي الجسم على المورد؛ وفي POST يحتوي على نتيجة الإجراء. 201 Created تم الإنشاء نجح الطلب وأنشأ موردًا جديدًا. وعادةً تشير ترويسة Location إليه. 202 Accepted تم القبول قُبل الطلب للمعالجة لكن المعالجة لم تنتهِ. النتيجة غير معروفة وقت الاستجابة. 203 Non-Authoritative Information معلومات غير موثوقة المصدر نجح الطلب، لكن خادمًا وكيلًا يحوّل المحتوى عدّل حمولة استجابة 200 الصادرة عن الخادم الأصلي. 204 No Content لا يوجد محتوى نجح الطلب ولا يوجد جسم لإعادته. قد تحمل الترويسات بيانات وصفية مثل ETag جديد. 205 Reset Content إعادة تعيين المحتوى نجح الطلب وعلى العميل إعادة تعيين عرض المستند، مثل تفريغ النموذج المُرسل. لا يُرسل جسم. 206 Partial Content محتوى جزئي يعيد الخادم جزءًا من المورد فقط كما طلبت ترويسة Range. وتحدد Content-Range البايتات المضمّنة. 207 Multi-Status حالات متعددة استجابة WebDAV يحتوي جسمها بصيغة XML على حالة منفصلة لكل مورد من عدة موارد تأثرت بطلب واحد. 208 Already Reported تم الإبلاغ مسبقًا يُستخدم داخل جسم WebDAV 207 للإشارة إلى أن موردًا ورد سابقًا في الاستجابة، لتجنب التكرار عندما تُكوّن الروابط حلقات. 226 IM Used تم استخدام IM لبّى الخادم طلب GET مع تطبيق معالجة واحدة أو أكثر على النسخة (ترميز الفروق)، فالجسم فرق وليس المورد الكامل.

3xx إعادة توجيه

على العميل اتخاذ خطوة إضافية، غالبًا الانتقال إلى عنوان URL جديد.

300 Multiple Choices خيارات متعددة للمورد عدة تمثيلات (لغة، صيغة) وعلى العميل أو المستخدم اختيار أحدها. قد يقترح الخادم خيارًا مفضلًا عبر Location. 301 Moved Permanently نُقل نهائيًا نُقل المورد نهائيًا إلى العنوان الوارد في Location. على العملاء ومحركات البحث استخدام العنوان الجديد من الآن فصاعدًا. 302 Found تم العثور عليه المورد مؤقتًا في عنوان آخر. على العملاء الاستمرار في استخدام العنوان الأصلي في الطلبات القادمة. 303 See Other انظر مكانًا آخر يوجّه الخادم العميل إلى جلب عنوان آخر بطريقة GET، عادةً لعرض نتيجة طلب POST. 304 Not Modified لم يتغير النسخة المخزنة لدى العميل ما زالت صالحة، لذا لا يرسل الخادم جسمًا. إنها رد على طلب مشروط بـ If-None-Match أو If-Modified-Since. 305 Use Proxy استخدم الوكيل مهجور. كان يطلب من العميل إعادة الطلب عبر الخادم الوكيل المذكور في Location. تتجاهله المتصفحات لأسباب أمنية. 307 Temporary Redirect إعادة توجيه مؤقتة المورد مؤقتًا في عنوان آخر، ويجب على العميل إعادة الطلب هناك بالطريقة والجسم نفسيهما. 308 Permanent Redirect إعادة توجيه دائمة نُقل المورد نهائيًا، ويجب على العملاء إعادة الطلب إلى العنوان الجديد بالطريقة والجسم نفسيهما.

4xx أخطاء العميل

في الطلب مشكلة يجب أن يصلحها العميل.

400 Bad Request طلب غير صالح لا يستطيع الخادم معالجة الطلب لأنه مشوّه: صياغة غير صالحة، أو تأطير خاطئ، أو قيم يتعذر تحليلها. 401 Unauthorized غير مصادق عليه يفتقر الطلب إلى بيانات اعتماد صالحة. رغم الاسم Unauthorized فهو يعني عدم المصادقة: سجّل الدخول أو أرسل رمزًا مميزًا صالحًا. 402 Payment Required الدفع مطلوب محجوز للاستخدام المستقبلي، لكن الخدمات عمليًا تعيده عندما يلزم الدفع أو خطة مدفوعة للمتابعة. 403 Forbidden محظور فهم الخادم الطلب لكنه يرفض تخويله. لن تفيد إعادة تسجيل الدخول ما لم تتغير الصلاحيات. 404 Not Found غير موجود لا يجد الخادم شيئًا في العنوان المطلوب. ولا يقول شيئًا عما إذا كان المورد موجودًا يومًا أو سيعود. 405 Method Not Allowed الطريقة غير مسموح بها العنوان موجود لكنه لا يدعم طريقة HTTP المستخدمة. وتسرد ترويسة Allow الطرق التي تعمل. 406 Not Acceptable غير مقبول لا يستطيع الخادم إنتاج استجابة بأي صيغة تسمح بها ترويسات Accept لدى العميل. 407 Proxy Authentication Required مطلوب مصادقة الوكيل خادم وكيل بين العميل والخادم يتطلب المصادقة قبل تمرير الطلب. 408 Request Timeout انتهت مهلة الطلب أغلق الخادم الاتصال لأن العميل لم يرسل طلبًا كاملًا في الوقت المحدد. 409 Conflict تعارض يتعارض الطلب مع الحالة الحالية للمورد، كوجود تكرار أو تعديل متزامن. 410 Gone زال نهائيًا زال المورد نهائيًا ولا يُعرف له عنوان جديد. وبخلاف 404، يصرّح الخادم بذلك عن قصد. 411 Length Required الطول مطلوب يتطلب الخادم ترويسة Content-Length والطلب لا يتضمنها. 412 Precondition Failed فشل الشرط المسبق شرط مسبق في ترويسات الطلب، مثل If-Match أو If-Unmodified-Since، كانت نتيجته خاطئة، فلم يطبّق الخادم الطلب. 413 Content Too Large المحتوى كبير جدًا جسم الطلب أكبر مما يرغب الخادم في معالجته أو يقدر عليه. كان يُسمى سابقًا Payload Too Large. 414 URI Too Long العنوان طويل جدًا عنوان URL للطلب أطول مما يقبل الخادم تفسيره. 415 Unsupported Media Type نوع وسائط غير مدعوم يرفض الخادم الطلب لأن نوع وسائط الجسم (Content-Type) أو ترميزه غير مدعوم. 416 Range Not Satisfiable النطاق غير قابل للتلبية تطلب ترويسة Range بايتات خارج حجم المورد. 417 Expectation Failed فشل التوقع لا يستطيع الخادم تلبية المتطلب الوارد في ترويسة Expect، وهو عادةً Expect: 100-continue. 418 I'm a teapot أنا إبريق شاي مزحة كذبة أبريل من بروتوكول Hyper Text Coffee Pot Control Protocol: الخادم إبريق شاي ويرفض تحضير القهوة. تستخدمه بعض المواقع مزاحًا أو لحظر الروبوتات. 421 Misdirected Request طلب موجّه خطأً وصل الطلب إلى خادم غير مهيأ للرد على ذلك المضيف، غالبًا لأن اتصال HTTP/2 أُعيد استخدامه لنطاق مختلف. 422 Unprocessable Content محتوى غير قابل للمعالجة الطلب سليم الصيغة لكنه يحتوي على أخطاء دلالية، فلا يستطيع الخادم معالجته. كان يُسمى سابقًا Unprocessable Entity. 423 Locked مقفل WebDAV: المورد مقفل، لذا لا يمكن تطبيق الطريقة. 424 Failed Dependency فشل الاعتمادية WebDAV: فشل الإجراء لأنه يعتمد على إجراء آخر في الطلب نفسه فشل. 425 Too Early مبكر جدًا يرفض الخادم معالجة طلب أُرسل ضمن البيانات المبكرة في TLS 1.3 (0-RTT) لأنه قد يُعاد تشغيله. 426 Upgrade Required الترقية مطلوبة يرفض الخادم الطلب بالبروتوكول الحالي ويطلب من العميل الترقية، مثلًا إلى TLS أو HTTP/2، كما هو مذكور في ترويسة Upgrade. 428 Precondition Required الشرط المسبق مطلوب يتطلب الخادم أن يكون الطلب مشروطًا (If-Match وما شابه) لمنع ضياع التحديثات. 429 Too Many Requests طلبات كثيرة جدًا أرسل العميل طلبات كثيرة جدًا خلال فترة معينة (تحديد المعدل). وقد تذكر Retry-After مدة الانتظار. 431 Request Header Fields Too Large حقول ترويسة الطلب كبيرة جدًا ترويسات الطلب كبيرة جدًا، سواء ترويسة واحدة أو جميعها معًا. 451 Unavailable For Legal Reasons غير متاح لأسباب قانونية لا يستطيع الخادم تقديم المورد لأسباب قانونية، مثل أمر قضائي أو رقابة حكومية. والرقم إشارة إلى رواية فهرنهايت 451. 499 Client Closed Request (غير قياسي) أغلق العميل الطلب يسجّل nginx الرمز 499 عندما يغلق العميل الاتصال قبل أن يرسل الخادم الاستجابة. لا يرى العميل هذا الرمز أبدًا.

5xx أخطاء الخادم

تعذّر على الخادم تنفيذ طلب صالح.