شعار Loona AutomationLoona أدوات المطوّرين
الرئيسية › المرجع

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

باختصار: كل رموز الحالة التي تهم في التطوير اليومي — ما يعني كل منها، متى يُستخدم، والفخاخ (401 مقابل 403، 302 مقابل 307) — قابلة للتصفية أثناء كتابتك.
🔒 خاص بالتصميم: كل شيء يعمل في متصفحك على هذا الجهاز. إدخالك لا يُرفع إلى خادم أبداً.
الكودالاسمالمعنى
100متابعةيجب أن يتابع العميل بجسم الطلب
101تبديل البروتوكولاتقُبلت ترقية البروتوكول (مثلاً إلى WebSocket)
200OKنجح الطلب — استجابة النجاح الافتراضية
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 للدائم).

أدوات مطوّرين ذات صلة

ضمّن هذه الأداة على موقعك — مجاناً

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