رموز حالة HTTP

رموز حالة HTTP هي أرقام من ثلاثة خانات يُرسلها الخادم في الاستجابة لوصف نتيجة طلبك. 200 يعني نجاح الطلب، 404 يعني أن الصفحة غير موجودة، و500 يعني أن الخادم واجه خطأً. الرقم الأول يُصنّف الرمز في إحدى خمس فئات — 2xx هو دائمًا نجاح، و5xx هو دائمًا خطأ في الخادم — لذا فإن معرفة الفئة تخبرك فورًا من أين تبدأ التصحيح: من جانب العميل أم من جانب الخادم.

الرقم الأول يحدد الفئة: 1xx معلوماتي (الطلب وصل وجارٍ المتابعة، مثل 100 Continue)، 2xx ناجح (نجح الأمر، مثل 200 OK)، 3xx إعادة توجيه (يجب الانتقال إلى مكان آخر، مثل 301 Moved Permanently)، 4xx خطأ في العميل (طلبك غير صحيح، مثل 404 Not Found)، و5xx خطأ في الخادم (الخادم هو من فشل، مثل 500 Internal Server Error). يمكنك التصفية حسب أي فئة في الأداة أعلاه لترى تلك المجموعة فقط مع شرح كل رمز.

الرموز التي ستواجهها يوميًا هي: 200 OK، 201 Created، 204 No Content، 301 و302 لإعادة التوجيه، 304 Not Modified، 400 Bad Request، 401 Unauthorized، 403 Forbidden، 404 Not Found، 429 Too Many Requests، 500 Internal Server Error، 502 Bad Gateway، و503 Service Unavailable. فعّل خيار 'الرموز الشائعة فقط' في الأداة أعلاه لتصفية القائمة الكاملة إلى هذه المجموعة الصغيرة مع أسباب وحلول لكل منها.

200 OK هو رد النجاح القياسي — لطلب GET يُعيد المورد في جسم الاستجابة، ولطلب POST يُعيد نتيجة العملية. 201 Created يعني أن طلب POST أو PUT نجح وأنشأ موردًا جديدًا؛ عادةً يضع الخادم عنوان المورد الجديد في رأس Location، مثل Location: /users/42. إذا كنت تبني واجهة برمجية وتنشئ موردًا، أعِد 201 مع رأس Location — وليس 200 — حتى يعرف العملاء أين يجدون الكائن الجديد.

404 يعني أن الخادم لم يعثر على أي شيء في ذلك الرابط — إما أنه غير موجود، أو نُقل، أو الرابط معطوب. لإصلاحه: تحقق من الرابط بحثًا عن أخطاء إملائية أو حالة حروف خاطئة، وأضف إعادة توجيه 301 من العنوان القديم إلى الجديد، وتحقق من قواعد التوجيه أو إعادة الكتابة في خادمك، وقدّم صفحة 404 مخصصة مفيدة. على خلاف 410 Gone، رمز 404 لا يعد بأن المورد اختفى نهائيًا، لذا تستمر محركات البحث في الزحف إليه.

301 Moved Permanently يُخبر بأن المورد انتقل إلى موطن جديد بشكل دائم، فتنقل محركات البحث إشارات الترتيب إلى الرابط الجديد وتُحدّث فهرستها — استخدمه عند تغيير رابط بشكل دائم. 302 Found مؤقت: الرابط الأصلي يبقى أساسيًا ويحتفظ بترتيبه، لذا استخدمه للتحويلات قصيرة الأمد كاختبارات A/B أو صفحة الصيانة. لطلبات غير GET، استخدم 308 (دائم) أو 307 (مؤقت) بدلًا من ذلك، لأنهما يحتفظان بطريقة HTTP بدلًا من السماح للمتصفحات بتحويل POST إلى GET.

403 Forbidden يعني أن الخادم فهم طلبك لكنه يرفض تفويضه — وعلى خلاف 401، فإن إرسال بيانات اعتماد لن يُفيد. الأسباب الشائعة: صلاحيات أو نطاقات مفقودة على الحساب، صلاحيات ملف خاطئة على الخادم (مثلًا ملف مضبوط على 600 بدلًا من 644)، حجب IP أو قاعدة WAF، أو تعطيل قائمة الدليل بدون وجود ملف فهرس. تحقق من أدوار الحساب وصلاحيات الملفات وأي قوائم مسموح بها. بعض الخوادم تُعيد عمدًا 403 بدلًا من 404 لتجنب الكشف عن وجود مورد.

كلها أخطاء 5xx في جانب الخادم لكنها تعني أشياء مختلفة. 500 Internal Server Error هو خطأ عام 'حدث شيء ما' — عادةً استثناء غير معالَج أو خطأ برمجي في التطبيق. 502 Bad Gateway يعني أن الوسيط تلقى ردًا غير صالح من خادم التطبيق الأعلى (غالبًا أنه تعطّل). 503 Service Unavailable يعني أن الخادم معطل مؤقتًا أو محمّل بشكل زائد — يجب أن يتضمن رأس Retry-After. 504 Gateway Timeout يعني أن الخادم الأعلى كان قابلًا للوصول لكنه كان بطيئًا جدًا في الرد في الوقت المحدد. ابدأ بسجلات الخادم للتمييز بينها عمليًا.

429 يعني أنك تجاوزت حد معدل الطلبات — طلبات كثيرة جدًا في نافذة زمنية معينة. يجب أن يتضمن الخادم رأس Retry-After يخبرك كم من الوقت تنتظر. لإصلاحه: احترم هذا الرأس، وأضف تراجعًا أسيًا بين المحاولات، وخزّن الردود مؤقتًا لتقليل حجم الطلبات، أو اطلب حصة أعلى. هذا شائع في الواجهات البرمجية العامة ونقاط النهاية لتسجيل الدخول الواقية من الإساءة. GitHub وStripe وTwitter/X كلها تستخدم 429 للتحكم في معدل استخدام الواجهة البرمجية.

أخطاء 4xx هي خطأ العميل — الطلب نفسه خاطئ، لذا فإن إعادة إرساله دون تغيير لن تُفيد (400 Bad Request، 401 Unauthorized، 404 Not Found). أخطاء 5xx هي خطأ الخادم — قد يكون طلبك صحيحًا تمامًا لكن الخادم فشل في تنفيذه (500، 502، 503)، لذا يمكن أن ينجح الطلب نفسه بمجرد تعافي الخادم. أصلح طلبك لأخطاء 4xx، وأصلح الخادم لأخطاء 5xx. هذا التمييز مهم لمنطق إعادة المحاولة: أعِد المحاولة فقط على ردود 5xx مع تراجع أسي — وليس على 4xx.

الرموز الأساسية هي: 200 OK (كل صفحة تريد فهرستها يجب أن تُعيد هذا)، 301 Moved Permanently (ينقل الترتيب إلى رابط جديد أثناء الترحيل)، 302 Found (مؤقت — يحافظ على الترتيب في الرابط الأصلي)، 404 Not Found و410 Gone (يُخبران برامج الزحف بأن الصفحة مفقودة؛ 410 يُزال من الفهرس أسرع لأنه دائم)، و503 Service Unavailable (الرمز الآمن للسيو أثناء التوقف المخطط — يُخبر Google بالعودة لاحقًا بدلًا من حذف الصفحات من الفهرس).

401 Unauthorized في الواقع يعني 'غير مُعرَّف' — لم تُثبت هويتك، لذا فإن إرسال بيانات اعتماد صالحة (رمز مميز، مفتاح API، أو جلسة تسجيل دخول) قد يُصلح الأمر؛ يجب على الخادم الرد برأس WWW-Authenticate. 403 Forbidden يعني أنك مُعرَّف لكنك ببساطة غير مسموح لك بالوصول إلى هذا المورد — بيانات اعتماد أفضل لن تُفيد، تحتاج إلى صلاحيات مختلفة. قاعدة بسيطة: 401 = من أنت؟، 403 = لا يُسمح لك بذلك.

كلها إعادات توجيه، لكن 307 و308 يضمنان الحفاظ على طريقة HTTP الأصلية والجسم، بينما يسمح تاريخيًا 301 و302 للعملاء بتحويل POST إلى GET عند الطلب الموجَّه. لذا 301 (دائم) و302 (مؤقت) مناسبان لإعادات توجيه الصفحات البسيطة، أما لنقطة نهاية تستقبل بيانات POST أو PUT، استخدم 308 للتحويلات الدائمة و307 للمؤقتة للحفاظ على الطريقة وتجنب فقدان البيانات.

الرموز في النطاق 520–530 هي رموز غير قياسية يُعيدها Cloudflare عندما يحدث خطأ بين Cloudflare وخادمك الأصلي — ليست جزءًا من مواصفة HTTP الرسمية لكنك ستراها باستمرار خلف Cloudflare. 520 يعني أن الخادم الأصلي أرسل ردًا فارغًا أو غير متوقع، 521 يعني أن الخادم الأصلي رفض الاتصال (معطل أو يحجب Cloudflare)، 522 يعني انتهاء مهلة اتصال TCP، 523 يعني أن الخادم الأصلي غير قابل للوصول، 524 يعني أن الخادم الأصلي اتصل به لكنه لم يرد في 100 ثانية، 525 و526 هما فشل في مصافحة SSL وشهادة غير صالحة، و530 عادةً ما يكون خطأ DNS في الخادم الأصلي مصحوبًا برمز 1xxx. ابحث عن أي من هذه الأرقام أعلاه للأسباب والحلول.

MDN Web Docs هو المرجع الرسمي للمواصفات لكنه لا يحتوي على شريط بحث مباشر، ولا تصفية حسب الفئة، ولا وضع ورقة مرجعية مضغوطة — تتصفح صفحة واحدة لكل رمز. httpstatuses.com يعرض الرموز في شبكة لكنه يحذف الأسباب والإصلاحات العملية. restapitutorial.com يغطي اتفاقيات REST بدون بحث تفاعلي. HTTP.cat موقع ترفيهي (كل رمز يقابله صورة قطة) لكنه غير عملي لتصحيح الأخطاء الفعلية. تجمع هذه الأداة مرجعًا قابلًا للبحث وتصفية حسب الفئة ووضع الورقة المرجعية وشرح الأسباب والحلول ورموز Cloudflare 5xx — كل ذلك في صفحة واحدة تعمل دون إنترنت وبدون إعلانات أو تسجيل.

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