أكواد حالة HTTPHTTP Status Codes

في كل مرة يرسل فيها المتصفح أو تطبيق الهاتف أو العميل البرمجي طلب إلى الخادم، فإنه يحتاج إلى إشارة رقمية فورية وحاسمة توضح مصير هذا الطلب. تمثل أكواد حالة HTTP () أرقاماً قياسية مكونة من ثلاثة أرقام يعيدها الخادم في سطر الحالة (أو داخل الحقل الزائف في و) لتحديد نتيجة معالجة الطلب بدقة.

تخضع هذه الأكواد لمعيار وسجل هيئة العالمي، وبناءً عليها يقرر المتصفح آلياً ما إذا كان سيعرض الصفحة، أو ينتقل إلى رابط بديل، أو يستخدم النسخة المخزنة مؤقتاً، أو يطلب تسجيل الدخول.

قبل الغوص في التفاصيل الهندسية، استعرض جدول المصطلحات التقنية الأساسية لهذا الدرس:

تُصنَّف جميع أكواد حالة هندسياً في خمس فئات رئيسية بحسب الرقم الأول من اليسار:

• الفئة الإعلامية (): استلم الخادم حقول الرأس المبدئية والعملية لا تزال مستمرة أو يجري تبديل البروتوكول.
• الفئة الناجحة (): استلم الخادم الطلب وفهمه ونفذه بنجاح تام.
• الفئة إعادة التوجيه (): يتطلب إتمام الطلب إجراءً إضافياً من المتصفح، مثل الانتقال إلى رابط جديد أو قراءة النسخة المخزنة محلياً.
• الفئة أخطاء العميل (): الخلل في الطلب المرسل من جهة العميل (صياغة خاطئة، نقص مصادقة، منع صلاحية، أو مسار غير موجود).
• الفئة أخطاء الخادم (): طلب العميل صحيح تماماً، لكن الخادم الأصلي أو البوابة الوسيطة تعذر عليهما إتمام المعالجة بسبب عطل داخلي أو ضغط زائد.

تمثل الفئة الإعلامية ردوداً تمهيدية مؤقتة يرسلها الخادم قبل الاستجابة النهائية، ولا تحتوي أبداً على جسم رسالة. تشمل هذه الفئة أربعة أكواد:

• كود (متابعة): عندما يعتزم العميل رفع ملف ضخم، يرسل أولاً حقول الرأس فقط مع الحقل ؛ فإذا وافق الخادم على الصلاحيات والحجم ردّ بكود ليبدأ العميل إرسال الجسم الفعلي دون إهدار الشبكة.
• كود (بروتوكولات التبديل): يعيده الخادم عند الموافقة على ترقية الاتصال عبر حقل الرأس ، وأشهر تطبيقاته الترقية من إلى بروتوكول الاتصال اللحظي ثنائي الاتجاه .
• كود (قيد المعالجة): استُخدم تاريخياً في امتدادات لإعلام العميل أن الخادم استلم طلباً طويلاً ولا يزال يعالجه لمنع انتهاء المهلة الزمنية.
• كود (تلميحات مبكرة): يرسله الخادم مبكراً أثناء تجهيز صفحة ليحمل حقول التي توجه المتصفح لتحميل ملفات والخطوط مسبقاً لتسريع العرض.

يُعد كود الكود القياسي الأشهر للدلالة على نجاح الطلب في بروتوكول . ووفق معيار ، تختلف دلالة الجسم المرفق مع بحسب طريقة الطلب:

• مع طريقة : جُلِب المورد المطلوب بنجاح وأُرسل تمثيله الكامل داخل جسم الاستجابة.
• مع طريقة : أُعيدت حقول الرأس الوصفية للمورد بنجاح دون إرسال جسم الرسالة.
• مع طرق أو أو : نُفذت العملية بنجاح ويحمل جسم الاستجابة بيانات توضح نتيجة التنفيذ أو الحالة المحدثة.

وإلى جانب ، تضم فئة النجاح أيضاً كود (استُلم الطلب ووُضع في طابور المعالجة غير المتزامنة بالخلفية) وكود (المستخدم في بث مقاطع الفيديو واستكمال التنزيلات الجزئية عبر حقل ).

عند بناء أو فحص واجهات البرمجة القياسية ()، يمنحك التمييز بين كودي و دقة هندسية أعلى من الاكتفاء بكود العام:

• كود (تم الإنشاء): يُعاد عندما ينجح طلب (غالباً أو ) في إنشاء سجل أو مورد جديد فعلياً على الخادم. ومن أفضل الممارسات القياسية إرفاق حقل الرأس متضمناً رابط المورد الجديد مع إرجاع بياناته في الجسم.
• كود (ناجح بدون محتوى): يُعاد عند نجاح عملية (مثل حذف سجل بـ أو حفظ تلقائي للإعدادات) دون حاجة لإرجاع أي بيانات في الجسم؛ ويُحظر احتواء استجابة على أي بايتات في الجسم.

مرجع بقية أكواد النجاح التخصصية في الفئة :

• كود (تم القبول للمعالجة): يُفيد باستلام الطلب ووضعه في طابور المعالجة غير المتزامنة بالخلفية (مثل تصدير تقرير ضخم أو معالجة فيديو) دون اكتمال النتيجة لحظياً.
• كود (معلومات معدلة لدى وسيط): يرسله خادم وسيط قام بتعديل بعض حقول الرأس أو التمثيل القادم من الخادم الأصلي.
• كود (إعادة تعيين المحتوى): يطلب من المتصفح تفريغ حقول النموذج () بعد نجاح الإرسال لتمكين إدخال سجل جديد، ولا يتضمن جسم رسالة.
• كود (المحتوى الجزئي): يُستخدم عند طلب جزء محدد من ملف كبير عبر حقل الرأس (مثل تقديم الفيديو أو استكمال تنزيل متوقف)، ويُرفق بحقل .
• الأكواد و و: أكواد متخصصة تُستخدم في عمليات المجمعة (إرجاع حالة عدة ملفات في رد واحد) وتطبيقات الفروق الجزئية.

تشير فئة إعادة التوجيه إلى أن إتمام الطلب يتطلب خطوة إضافية من العميل. وفي أكواد التوجيه إلى عنوان جديد ( و و و و)، يرسل الخادم الرابط الهدف داخل حقل رأس الاستجابة .

فور استلام المتصفح لكود توجيه مرفق بحقل ، فإنه يرسل تلقائياً طلباً جديداً إلى العنوان البديل (مع وجود سقف أمان يقارب 20 تحويلاً متتالياً لمنع حلقات التوجيه اللانهائية ). أما في أداة سطر الأوامر ، فيجب تمرير الخيار لتتبع مسار التوجيه آلياً.

• كود (خيارات متعددة): يُفيد بوجود عدة تمثيلات للمورد المطلوب ليختار العميل أو المتصفح الأنسب منها.
• كود (انظر موقعاً آخر): يوجه المتصفح بعد إرسال نموذج للانتقال إلى صفحة تأكيد الطلب باستخدام طريقة حصراً (نمط الذي يمنع تكرار الدفع عند تحديث الصفحة).
• الكودان و: أكواد تاريخية قديمة أُلغي العمل بها في المتصفحات الحديثة لدواعٍ أمنية.

يُعد التمييز بين أنواع إعادة التوجيه الدائمة والمؤقتة وتأثيرها على طريقة الطلب أمراً جوهرياً لمحركات البحث () وواجهات البرمجة:

• الفرق بين و: يخبر كود المتصفحات ومحركات البحث أن الرابط انتقل بشكل دائم ونهائي إلى العنوان الجديد في (فتُنقل قوة الأرشفة للرابط الجديد)، بينما يدل كود على أن التحويل مؤقت ويجب الاستمرار في طلب الرابط الأصلي مستقبلاً.
• الحفاظ على طريقة الطلب في و مقابل : تاريخياً، كانت المتصفحات تحوّل طلب إلى عند تلقي أو . ولحسم ذلك هندسياً، خُصص كود لتحويل إلى عمداً بعد إرسال النماذج، بينما يضمن كودا و الاحتفاظ بنفس طريقة الطلب ( يبقى ) ونفس الجسم دون تغيير.

رغم وقوع كود ضمن الفئة ، فإنه لا يوجه المتصفح إلى رابط آخر، بل يمثل حجر الزاوية في التحقق الشرطي من التخزين المؤقت (). فعندما تنتهي مدة صلاحية ملف مخزن في المتصفح، يرسل المتصفح طلباً مشروطاً يتضمن حقل مع بصمة المحفوظة لديه.

إذا لم يتغير الملف على الخادم، يرد الخادم فوراً بكود دون إرسال أي جسم، ليستخدم المتصفح نسخته المحلية مباشرة ويوفر إعادة تنزيل الملف.

ضمن فئة أخطاء العميل ، يساعد التفريق الهندسي بين كود وكود على تشخيص سبب رفض البيانات بدقة:

• كود (خطأ صياغي أو تركيبي): يعجز الخادم عن قراءة الطلب أصلاً بسبب عطب في الصياغة، مثل إرسال نص مكسور ينقصه قوس إغلاق أو حقول رأس مشوهة.
• كود (خطأ في التحقق المنطقي): صياغة الطلب وملف سليمة تماماً وقد قرأها الخادم بنجاح، لكن القيم المرسلة تخالف قواعد التحقق المنطقية (مثل إرسال بريد إلكتروني غير صالح أو كلمة مرور أقصر من الحد الأدنى).

يُعد الفرق بين كود وكود من أهم المفاهيم الهندسية والأمنية في تطوير الويب:

• كود (غياب المصادقة — «من أنت؟»): يعني أن الطلب يفتقر إلى إثبات هوية صالح ()، كأن يحاول الزائر فتح صفحة حسابه دون تسجيل الدخول أو برمز جلسة منتهي الصلاحية. ويلزم المعيار إرفاق حقل الرأس مع استجابة .
• كود (رفض الصلاحية — «أعرف هويتك، لكن لا تملك الصلاحية»): يعني أن الخادم تحقق من هوية المستخدم المسجل فعلياً، لكن هذا الحساب لا يملك صلاحية الوصول () للمورد المطلوب (مثل محاولة حساب مستخدم عادي فتح لوحة تحكم المشرفين).

يُعد كود أشهر أكواد الحالة على الإطلاق، ويعني أن الخادم لم يعثر على أي مورد يطابق المسار المطلوب ()، أو أن الخادم يختار أمنياً إخفاء وجود مورد خاص عن مستخدم غير مخول بمعرفة وجوده أصلاً.

ومن الأكواد الشقيقة المهمة كود ، الذي يخبر محركات البحث بأن هذا الرابط كان موجوداً في السابق لكنه حُذف نهائياً عن عمد دون رابط بديل، مما يسرّع إزالته من فهارس البحث مقارنةً بكود .

يُعاد كود عندما يكون المسار المطلوب موجوداً فعلاً على الخادم، لكنه لا يقبل طريقة الطلب () المستخدمة؛ مثل إرسال طلب حذف إلى رابط مقالة ثابتة لا تقبل سوى القراءة عبر و.

ويلزم معيار الخادمَ عند إرجاع كود بأن يُرفق وجوباً حقل الرأس موضحاً فيه قائمة الطرق المسموح بها لهذا المورد.

يُستخدم كود (المعرّف في المعيار ) لإبلاغ العميل بأنه تجاوز الحد الأقصى المسموح به من الطلبات خلال فترة زمنية محددة ().

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

يمثل كود الكود العام لأخطاء الخادم الداخلية؛ ويعني أن طلب العميل وصل سليماً، لكن تطبيق الخادم واجه استثناءً برمجياً غير معالج أو فشل اتصال بقاعدة البيانات منعه من إكمال العملية.

ويجاوره في الفئة نفسها كود ، الذي يعني أن الخادم لا يدعم الوظيفة أو طريقة الطلب المرسلة على مستوى الخادم بالكامل.

تعتمد تطبيقات الويب الحديثة على خوادم عكسية وموازنات أحمال وشبكات (مثل و) تقف كبوابة أمام الخادم التطبيقي الخلفي. وعند حدوث خلل بين البوابة والخادم الخلفي، تحدد ثلاثة أكواد موضع المشكلة بدقة:

• كود (بوابة سيئة): تواصل الخادم الوسيط مع الخادم الخلفي، لكنه تلقى منه رداً تالفاً أو مقطوعاً (كأن تتوقف خدمة التطبيق الخلفية فجأة أثناء الرد).
• كود (الخدمة غير متاحة مؤقتاً): الخادم غير قادر حالياً على استقبال الطلبات بسبب ضغط هائل مؤقت أو وجوده في وضع الصيانة المجدولة، وغالباً ما يرفق بحقل .
• كود (انتهاء مهلة البوابة): أرسل الخادم الوسيط الطلب إلى الخادم الخلفي وانتظر الرد، لكن الخادم الخلفي استغرق وقتاً طويلاً تجاوز المهلة الزمنية المحددة دون إجابة.

استخدم محاكي القرارات التفاعلي الآتي لاختبار كيف يختار الخادم كود الحالة الأدق في سيناريوهات الإنشاء والتحقق والصلاحيات وأخطاء البوابة:

يمكنك فحص ومراقبة أكواد حالة عملياً في الوقت الفعلي عبر أدوات مطوري المتصفح () أو عبر سطر الأوامر :

• داخل تبويب الشبكة في المتصفح (): يعرض عمود كود الحالة لكل طلب مميزاً بالألوان (الأخضر لنجاح ، والرمادي أو الأصفر للتوجيه ، والأحمر لأخطاء ). احرص على تفعيل خيار (الاحتفاظ بالسجل) قبل النقر على الروابط لمشاهدة سلسلة تحويلات قبل وصول صفحة النهائية.
• عبر سطر الأوامر : استخدم الخيار لجلب سطر الحالة وحقول الرأس فقط، أو الخيار لطباعة الرقم الثلاثي لكود الحالة مباشرة.

تدرّب في محاكي فاحص الشبكة التفاعلي الآتي على تتبع سلاسل أكواد الحالة كما تظهر في تبويب مع تفعيل :