أداة البحث عن رموز حالة HTTP

ابحث عن أي رمز حالة HTTP — 200 و404 و500 وكل ما بينها — مع شرح بلغة بسيطة لما يعنيه ومتى تُعيده الخوادم.

ما هي أداة البحث عن رموز حالة HTTP؟

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

تغطي أداة البحث هذه الرموز الأكثر شيوعًا عبر الفئات الخمس كافة — الإعلامية (1xx)، والنجاح (2xx)، وإعادة التوجيه (3xx)، وخطأ العميل (4xx)، وخطأ الخادم (5xx) — مع شروحات بلغة بسيطة لما يعنيه كل منها فعليًا في الممارسة، وليس فقط التعريف الرسمي في معيار RFC.

الصيغة

1xx: إعلامي — تم استلام الطلب، والعملية مستمرة

2xx: نجاح — تم استلام الطلب وقبوله بنجاح

3xx: إعادة توجيه — يلزم اتخاذ إجراء إضافي لإتمام الطلب

4xx: خطأ من العميل — الطلب يحتوي على صيغة خاطئة أو لا يمكن تلبيته

5xx: خطأ من الخادم — فشل الخادم في تلبية طلب صالح

كيفية الحساب

اكتب رمز حالة (مثل 404) أو كلمة مفتاحية (مثل "forbidden") في مربع البحث.
صفِّ حسب الفئة باستخدام أزرار 1xx-5xx إذا أردت تصفح نطاق معيّن.
اقرأ الوصف البسيط لما يعنيه الرمز ومتى يُعاد عادةً.
استخدم هذه الأداة كمرجع سريع أثناء تشخيص استجابات واجهة برمجة التطبيقات أو بناء معالجة الأخطاء.

مثال

البحث عن "429" يُعيد "Too Many Requests" — الرمز الذي تعيده واجهات برمجة التطبيقات عندما تتجاوز حد معدل الطلبات، مخبرًا إياك بالتباطؤ وإعادة المحاولة بعد تأخير.

الفوائد الرئيسية

كل رمز حالة شائع الاستخدام في مرجع واحد قابل للبحث
شروحات بلغة بسيطة، وليست مجرد نص RFC الرسمي
تصفية فورية حسب الفئة (من 1xx إلى 5xx)
مجانية وسريعة ولا تتطلب تسجيلًا

الأخطاء الشائعة التي يجب تجنبها

إعادة 200 OK لطلب فشل فعليًا، مما يخفي الأخطاء عن أدوات المراقبة
الخلط بين 401 (غير مصادَق عليه) و403 (مصادَق عليه لكن غير مصرَّح له)
استخدام 302 لإعادة توجيه ينبغي أن تكون دائمة (301)، مما يضر بتحسين محركات البحث
التعامل مع جميع أخطاء 4xx و5xx بالطريقة نفسها في معالجة الأخطاء من جانب العميل بدلًا من التفريع حسب الرمز المحدد

نصائح احترافية

خصص رموز 5xx حصريًا لأخطاء جانب الخادم — لا تستخدمها أبدًا للإشارة إلى أخطاء إدخال من العميل
استخدم 429 مع رأس Retry-After عند تقييد المعدل، حتى تعرف العملاء الملتزمون متى يعيدون المحاولة
فضّل استخدام 404 على صفحة خطأ عامة كلما لم يكن المورد موجودًا فعليًا — فهذا أفضل لكل من المستخدمين ومحركات البحث
عند تصميم واجهة برمجة تطبيقات، اختر رموز 4xx محددة (422، 409، 400) بدلًا من الاكتفاء برمز 400 عام افتراضيًا

شرح المصطلحات الأساسية

سطر الحالة (Status line): السطر الأول من استجابة HTTP، ويحتوي على رمز الحالة وعبارة سبب موجزة
المتماثل الفعل (Idempotent): خاصية لبعض طرق HTTP حيث يكون لتكرار الطلب نفسه التأثير ذاته لتنفيذه مرة واحدة
سلسلة إعادة التوجيه: تسلسل من عمليات إعادة توجيه متعددة يتّبعها المتصفح قبل الوصول إلى المورد النهائي
تقييد المعدل (Rate limiting): تقييد عدد الطلبات التي يمكن لعميل ما إجراؤها ضمن إطار زمني معيّن، وغالبًا ما يُشار إليه بالرمز 429

حالات الاستخدام الشائعة

فهم سريع لرمز حالة غير مألوف تعيده واجهة برمجة تطبيقات تقوم بدمجها
تحديد رمز الحالة الذي ينبغي إعادته من واجهة برمجة التطبيقات الخاصة بك لحالة خطأ معينة
تشخيص سبب فشل طلب من خلال التحقق مما يعنيه رمز معيّن فعليًا
تعليم أو تعلّم أساسيات HTTP في مادة دراسية لتطوير الويب
كتابة منطق دقيق لمعالجة الأخطاء يميّز بين حالات 4xx و5xx المختلفة

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

ماذا تعني نطاقات رموز حالة HTTP المختلفة؟

رموز 1xx إعلامية، و2xx تعني النجاح، و3xx تشير إلى إعادة توجيه، و4xx تعني أن العميل ارتكب خطأ (مثل طلب صفحة مفقودة)، و5xx تعني أن الخادم نفسه فشل في تلبية طلب صالح.

ما الفرق بين 401 و403؟

401 Unauthorized تعني أنك لم تُصادق (أو أن بيانات اعتمادك غير صالحة) — الخادم لا يعرف من أنت. أما 403 Forbidden فتعني أن الخادم يعرف من أنت لكن ليست لديك صلاحية الوصول إلى المورد.

لماذا أرى أحيانًا 200 لصفحة فشل تحميلها بوضوح؟

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

ما الفرق بين إعادة التوجيه 301 و302؟

تخبر 301 Moved Permanently المتصفحات ومحركات البحث بتحديث سجلاتها واستخدام عنوان URL الجديد من الآن فصاعدًا. أما 302 Found فتشير إلى إعادة توجيه مؤقتة — وينبغي الاستمرار في استخدام عنوان URL الأصلي في الطلبات المستقبلية.