مرجع رموز حالة HTTP
| الكود | الاسم | المعنى |
|---|---|---|
| 100 | متابعة | يجب أن يتابع العميل بجسم الطلب |
| 101 | تبديل البروتوكولات | قُبلت ترقية البروتوكول (مثلاً إلى WebSocket) |
| 200 | OK | نجح الطلب — استجابة النجاح الافتراضية |
| 201 | أُنشئ | تم إنشاء مورد جديد (نجاح POST النمطي) |
| 202 | مقبول | في قائمة الانتظار للمعالجة غير المتزامنة، لم يكتمل بعد |
| 204 | لا محتوى | نجاح مع جسد فارغ عمداً |
| 301 | نُقل دائماً | للمورد رابط دائم جديد — حدّث الروابط؛ قيمة SEO تنتقل |
| 302 | وُجد | إعادة توجيه مؤقتة (أُسيء استخدامها تاريخياً؛ اطّلع على 303/307) |
| 303 | اطّلع على آخر | إعادة توجيه إلى GET على رابط آخر (post/redirect/get) |
| 304 | غير معدّل | النسخة المخزّنة ما تزال صالحة — أعد التحقق عبر ETag/Last-Modified |
| 307 | إعادة توجيه مؤقتة | إعادة توجيه مؤقتة تحفظ الطريقة والجسد |
| 308 | إعادة توجيه دائمة | إعادة توجيه دائمة تحفظ الطريقة والجسد |
| 400 | طلب سيئ | لا يستطيع الخادم تحليل/فهم الطلب |
| 401 | غير مصرّح | المصادقة مطلوبة أو فشلت (رغم الاسم، فهو يعني غير مُصادق) |
| 403 | محظور | سواء مُصادقاً أم لا، الوصول مرفوض |
| 404 | غير موجود | لا مورد على هذا الرابط |
| 405 | الطريقة غير مسموحة | طريقة HTTP غير مدعومة لهذا المورد |
| 406 | غير مقبول | لا تمثيل يطابق ترويسات القبول |
| 408 | مهلة الطلب | استغرق العميل وقتاً طويلاً لإرسال الطلب |
| 409 | تعارض | تعارض حالة، مثال تصادم تحرير أو إنشاء مكرّر |
| 410 | ذهب | أُزيل دائماً (أقوى من 404 — يُستخدم عمداً) |
| 411 | الطول مطلوب | ترويسة Content-Length مطلوبة |
| 413 | المحتوى كبير جداً | جسد الطلب يتجاوز حدود الخادم |
| 414 | الرابط طويل جداً | الرابط يتجاوز حدود الخادم |
| 415 | نوع وسائط غير مدعوم | نوع محتوى الطلب غير مدعوم |
| 418 | أنا إبريق شاي | رمز مزاح RFC 2324، يُستخدم أحياناً لرفض تحضير القهوة |
| 422 | محتوى غير قابل للمعالجة | الصياغة جيدة لكن الدلالات تفشل التحقق (واجهات API تحب هذا) |
| 425 | مبكر جداً | الخادم غير راغب في معالجة طلب قد أُعيد تشغيله |
| 429 | طلبات كثيرة جداً | حُدّ معدل الضرب — تراجع، والتزم بـ Retry-After |
| 500 | خطأ داخلي في الخادم | فشل عام في الخادم |
| 501 | غير منفّذ | لا يدعم الخادم الوظيفة |
| 502 | بوابة سيئة | تلقّى وكيل/بوابة رداً غير صالح من المنبع |
| 503 | الخدمة غير متاحة | محمّل زائداً أو متوقف للصيانة — مؤقت غالباً، قد يحمل Retry-After |
| 504 | انتهت مهلة البوابة | انتهت مهلة وكيل/بوابة في انتظار المنبع |
| 505 | إصدار HTTP غير مدعوم | إصدار HTTP في الطلب غير مدعوم |
حول
رموز الحالة هي ملخص الخادم برقم واحد لكل استجابة، مجمّعة حسب الفئة: 1xx معلوماتية، 2xx نجاح، 3xx إعادة توجيه، 4xx أخطأ العميل، 5xx أخطأ الخادم. يعطي الجدول الرموز التي يلتقيها المطوّرون العاملون فعلياً، مع الفروق الدقيقة المهمة عملياً — 401 يعني غير مصادَقة رغم اسمها، 403 رفض بغض النظر عن تسجيل الدخول، 422 فشل تحقق API، 429 يطالب بالتراجع. الرموز غير المدرجة (الذيل الطويل من 1xx والرموز التجريبية) نادرة بما يكفي بأن الفئة وحدها تخبرك كيف تتعامل معها.
الأسئلة الشائعة
ما الفرق بين 401 و403؟
401: لا نعرف من أنت (قم بالمصادقة). 403: نعرفك، ومع ذلك لا يُسمح لك.
302 أم 307 لإعادة التوجيه المؤقت؟
يحافظ 307 على الطريقة والجسم؛ أما 302 فقد سمح تاريخياً للعملاء بتحويل POST إلى GET. يجب أن تستخدم الأعمال الجديدة 307 (أو 308 للدائم).