رموز حالة HTTP

ما مرجع رموز حالة HTTP؟#

تحمل كلّ استجابة HTTP رمز حالة من ثلاثة أرقام يُخبر العميل، في رقم واحد، بما حدث لطلبه. الأرقام ليست عشوائية: الرقم الأول يُسمّي عائلة — 1xx يعني «انتظر، أُرسل معلومات»، و2xx يعني «إليك، نجح»، و3xx يعني «اذهب للبحث في مكان آخر»، و4xx يعني «أنت، العميل، أخطأت»، و5xx يعني «أنا، الخادم، أخطأت». احفظ تلك العائلات الخمس فتستطيع قراءة أيّ تبادل HTTP بنظرة، سواء كان طلب متصفّح، أو curl أرسلته، أو خطأ في سجلّات تطبيقك.

المشكلة أنّ هناك أكثر من ستّين رمزًا قيد الاستخدام الفعليّ، والفروق بين الجيران دقيقة غالبًا: 401 مقابل 403، و302 مقابل 307، و422 مقابل 400. هذه الصفحة مرجع قابل للبحث لكلّ منها — الرمز، وعبارة السبب الخاصة بـ IANA، والعائلة، وتفسير مبسَّط. اكتب رقمًا أو كلمة فتضيق الجدول فورًا.

كيف تستخدمها#

1. تصفَّح أو ابحث. يعدّد الجدول كلّ رمز مُجمَّع بعائلة (1xx حتى 5xx). استخدم صندوق البحث في الأعلى للترشيح.
2. ابحث بطريقة تفكيرك. المُرشِّح ذكيّ تجاه القصد:
   • اكتب رقمًا مثل 30 أو 418 فيطابق الرموز بالبادئة — 30 يُظهر عائلة إعادة التوجيه 3xx كاملة.
   • اكتب كلمة مثل redirect أو timeout أو teapot فيبحث في عبارة السبب والوصف، دون تمييز بين الأحرف الكبيرة والصغيرة.
3. اقرأ الصفّ. يُظهر كلّ صفّ الرمز (الرقم)، والسبب (العبارة القياسيّة مثل «Not Found»)، والفئة (تسمية العائلة المحلية)، والوصف (شرح قصير لمتى يُعاد ذلك الرمز). يُعرِض شريط الحالة أسفل الجدول كم صفًّا طابق.

أبرز المزايا#

• مجموعة IANA الكاملة، بالإضافة إلى الرموز الفعليّة. تغطّي كلّ رمز يُعيده الويب فعلًا، من 100 Continue حتى 511 Network Authentication Required، بما في ذلك مداخل WebDAV الخاصّة 207/208/226، والرمز المازح 418 I'm a Teapot، و451 المفروض قانونيًّا.
• بحث أرقام يدرك البادئة. كتابة 4 لا تُلقي مجموعة عشوائيّة فرعيّة — بل تُعطيك كلّ خطأ عميل 4xx بالترتيب، وهو بالضبط كيف تستكشف عائلة لا تتذكّرها.
• بحث كلمات عبر السبب والوصف. «rate» تجد 429 Too Many Requests؛ «range» تجد 416 Range Not Satisfiable؛ «auth» يُظهر 401 و407 معًا.
• عبارات السبب كليّة. العبارات («Not Found»، «Gateway Timeout») معرِّفات تقنيّة لا ترجمات — تطابق ما يُرسله الخوادم فعلًا على السلك، فيمكنك لصقها مباشرةً في توثيق أو متتبِّع قضايا.
• يعمل بالكامل في متصفّحك. تُسلَّم مجموعة البيانات مع الصفحة؛ الترشيح يجري محليًّا بلا طلب شبكة.

مثال عملي#

ثلاثة رموز تُعثِر تقريبًا كلّ مطوّر مرّة واحدة على الأقلّ هي ثلاثيّة خطأ العميل 401 و403 و404. ابحث عن الأرقام 40 فتحصل عليها كلّها في عرض واحد، جنبًا إلى جنب:

• 401 Unauthorized — «المصادقة مطلوبة وقد فشلت أو لم تُقدَّم.» لا يعرف الخادم من أنت. الإصلاح: أرسل بيانات اعتماد (رمز دخول، مفتاح API).
• 403 Forbidden — «الطلب كان صالحًا لكنّ الخادم يرفض الإجراء (حقوق غير كافية).» يعرف الخادم من أنت تمامًا، ولا تزال لا تستطيع الحصول على هذا. الإصلاح: احصل على إذن، لا كلمة مرور أخرى.
• 404 Not Found — «تعذّر إيجاد المورد المطلوب.» URL نفسه خاطئ أو المورد اختفى. الإصلاح: صحِّح المسار.

التمييز الأكثر فائدة هو 401 مقابل 403: «لا أعرفك» (سجِّل الدخول) مقابل «أعرفك، ولا» (اطلب الوصول). إعادة المصادقة لن تُصلح 403 أبدًا، والعبث بـ URL لن يُصلح 401 أبدًا.

البحث الثاني المفيد هو عائلة إعادة التوجيه. ابحث 30 فترى أنّ 301 و302 سمحا تاريخيًّا للعملاء بتغيير المنهج في الطلب التالي (يمكن أن يتدهور POST إلى GET)، بينما قدِّم 307 و308 تحديدًا للحفاظ على المنهج الأصليّ — ولهذا تُشير إليك واجهات API الحديثة التي تعيد توجيه عمليات إرسال النماذج عند 307/308 بدلًا من 301/302.

الأسئلة الشائعة#

ماذا يعني الرقم الأول من رمز الحالة؟#

يُسمّي العائلة. 1xx معلوماتيّ (الخادم يقول «انتظر، المزيد قادم»)، و2xx نجاح، و3xx إعادة توجيه (ابحث في مكان آخر)، و4xx خطأ عميل (طلبك كان خاطئًا)، و5xx خطأ خادم (الطلب كان جيّدًا لكنّ الخادم فشل). الرقمان المتبقّيان يُعرِّفان الرمز المحدَّد داخل تلك العائلة.

هل 418 رمز حالة حقيقيّ؟#

نشأ كـ RFC يوم كذبة أبريل عن غلاية شاي ترفض تخمير القهوة، فهو ليس مخصَّصًا للإنتاج. ومع ذلك، بعض الخدمات تُعيد 418 فعلًا كردّ مازح «أرسلت لي شيئًا بلا معنى»، ومن غير الضارّ التعرّف عليه. يعدّده هذا المرجع لأنّك ستواجهه في البريّة.

لماذا تُعلَّم بعض الرموز WebDAV؟#

رموز مثل 207 Multi-Status و423 Locked و507 Insufficient Storage عُرِّفت لـ WebDAV، امتداد HTTP لتحرير الملفات التشاركيّ. هي نادرة على واجهات API العاديّة لكنّها تظهر في أنظمة تُظهر واجهة شبيهة بنظام ملفات، فتُشير الأوصاف إلى أصل WebDAV ليُفهم السياق.

من أين تأتي عبارات السبب؟#

إنّها عبارات السبب الإنجليزيّة القياسيّة المُسجَّلة لدى IANA — السلاسل نفسها التي يُلحِقها الخوادم بالرمز على سطر الحالة (مثلًا، HTTP/1.1 404 Not Found). إنّها معرِّفات تقنيّة، فتُعرَض حرفيًّا بدل الترجمة؛ الجزء المُترجَم من الصفحة هو ترويسات الأعمدة، وتسميات الفئات، وهذا النصّ التفسيريّ.