🌐 رموز HTTP التي يجب أن يعرفها كل مطوّر
من 200 إلى 504 — دليل سريع بالرموز الأكثر شيوعاً مع معناها الحقيقي وليس فقط اسمها الرسمي.
( علّق هذا في مكان تراه )
✅ 2xx — نجاح الطلب
🔹 نجح الطلب. الأكثر انتشاراً. (200 OK)
🔹 تمّ إنشاء المورد. تستخدمه POST عادةً. (201 Created)
🔹 نجح الطلب ولا شيء يُردّ. شائع في طلبات الحذف. (204 No Content)
🔀 3xx — التوجيه
🔹 العنوان تغيّر للأبد. غيّر روابطك. (301 Moved Permanently)
🔹 تحويل مؤقت. يُعيد المتصفح المحاولة على نفس العنوان لاحقاً. (302 Found)
🔹 النسخة المخزّنة لا تزال صالحة. لا تُنزَّل البيانات من جديد. (304 Not Modified)
⚠️ 4xx — خطأ من طرف العميل
🔹 الطلب مشوّه أو ناقص. تحقق من الـ payload. (400 Bad Request)
🔹 لم تُرسَل بيانات المصادقة أو انتهت صلاحيتها. (401 Unauthorized)
🔹 البيانات صحيحة لكن ليس لديك صلاحية. مختلف تماماً عن 401. (403 Forbidden)
🔹 المورد غير موجود أو الرابط خاطئ. (404 Not Found)
🔹 تعارض في الحالة. مثال: بريد إلكتروني موجود مسبقاً. (409 Conflict)
🔹 البنية سليمة لكن القيم مرفوضة منطقياً. شائع في التحقق من البيانات. (422 Unprocessable Entity)
🔹 تجاوزت حد الاستدعاءات. انتظر أو طبّق Exponential Backoff. (429 Too Many Requests)
🔥 5xx — خطأ من طرف الخادم
🔹 الخادم انكسر. راجع السجلات. (500 Internal Server Error)
🔹 الخادم الوسيط استقبل ردّاً سيئاً من الخادم الخلفي. (502 Bad Gateway)
🔹 الخادم مشغول أو في صيانة. أضف Retry-After في الرد. (503 Service Unavailable)
🔹 الخادم الخلفي لم يردّ في الوقت المحدد. (504 Gateway Timeout)
القاعدة الذهبية: 4xx = أصلح في الكود. 5xx = أصلح في الخادم أو انتظر.