كيفية استخدام مرجع رموز حالة HTTP
- اكتب رمز حالة (429) أو فئة (5xx) أو كلمة مفتاحية مثل «conflict».
- اقرأ بطاقة التفاصيل لمعرفة المعنى ومرجع RFC وإرشادات الاستخدام وتلميح الاختبار.
- استخدم مرشّح الفئة أو ألغِ تحديد الرموز غير القياسية لتضييق نطاق الجدول.
- انسخ الجدول أو نزّله بصيغة CSV لاستخدامه في خطط الاختبار والتوثيق.
مزايا مرجع رموز حالة HTTP
- جميع رموز الحالة المسجّلة لدى IANA من 100 إلى 511 مع المعنى والقسم المقابل في RFC 9110 والأسباب الشائعة
- الرموز غير القياسية الشائعة الاستخدام (Cloudflare 52x، وNginx 444/499، وAWS ELB 460/463، وLaravel 419) مميّزة بوضوح
- البحث بالرقم الكامل أو الفئة (4xx) أو جزء من الرقم (50) أو كلمة مفتاحية («rate limit» أو «redirect»)
- تلميحات لاختبار الجودة: ما الذي يجب اختباره، وأي الترويسات ينبغي التحقق منها، وهل إعادة المحاولة آمنة، وهل الاستجابة قابلة للتخزين المؤقت
- شرح الرموز غير المخصّصة وفق دلالات فئتها بدلاً من إرجاع نتيجة فارغة
- التصفية حسب الفئة وإخفاء رموز المورّدين عندما تريد الرموز القياسية فقط
مثال على مرجع رموز حالة HTTP
البحث عن الرمز 429
الإدخال:
429النتيجة:
429 Too Many Requests — 4xx Client Error
RFC 6585 §4
When to use: API throttling per key, per IP or per user.
Testing hint: burst requests above the limit; verify Retry-After and X-RateLimit-* headers.
Retry safe? Yes — with backoff (honour Retry-After)الأسئلة الشائعة حول مرجع رموز حالة HTTP
ما الفرق بين 401 و403؟
يعني 401 Unauthorized أن الطلب لا يحمل بيانات اعتماد صالحة (رمز مفقود أو منتهي الصلاحية أو خاطئ)، ويجب أن يتضمّن تحدّي WWW-Authenticate. أما 403 Forbidden فيعني أن العميل مصادَق عليه لكنه غير مخوَّل بتنفيذ هذا الإجراء. تصحّح إعادة المصادقة الخطأ 401، لكنها لا تصحّح الخطأ 403 أبداً.
هل أستخدم 301 أم 308 لإعادة التوجيه الدائمة؟
كلاهما دائم. يسمح 301 للعملاء بتحويل طلب POST إلى GET، بينما يضمن 308 الحفاظ على الطريقة (method) والمتن. استخدم 301 للصفحات و308 لنقاط نهاية API التي تستقبل طلبات غير GET.
ما رموز الحالة التي يمكن إعادة محاولتها تلقائياً بأمان؟
الرموز 429 و502 و503 و504 و408 عابرة ويمكن إعادة محاولتها مع تراجع أسّي (exponential backoff) مع احترام ترويسة Retry-After. أما رموز 4xx الأخرى غير 408 و429 فتشير إلى مشكلة في جانب العميل ولا ينبغي إعادة محاولتها دون تغيير.
هل رموز Cloudflare 52x رموز HTTP حقيقية؟
ليست مسجّلة لدى IANA. تُرجع Cloudflare الرموز 520–530 لوصف المشكلات بين حافتها (edge) وخادم الأصل الخاص بك. تعرضها الأداة مميّزة بأنها غير قياسية حتى تتمكن من تشخيصها بسرعة.
ماذا يعني رمز غير مخصّص مثل 499؟
يجب على العملاء التعامل مع الرموز غير المعروفة كما لو كانت الرمز x00 في فئتها (فمثلاً يُعامل 499 معاملة 400). يستخدم Nginx الرمز 499 في سجلاته للدلالة على «إغلاق العميل للطلب». يشرح المرجع مثل هذه الاستخدامات الخاصة بالمورّدين حيثما وُجدت.
ملاحظات تقنية
يتبع المرجع معيار RFC 9110 (دلالات HTTP، 2022) الذي ألغى RFC 7231 وأعاد تسمية بعض الرموز (413 Content Too Large و422 Unprocessable Content). كما تُدرج رموز WebDAV وRFC 6585 وRFC 8297 مع مراجعها الخاصة.
تتبع قابلية التخزين المؤقت قائمة RFC 9110 للرموز القابلة للتخزين المؤقت استدلالياً (200 و203 و204 و206 و300 و301 و308 و404 و405 و410 و414 و501)؛ ويتطلب أي رمز آخر توجيهات Cache-Control صريحة حتى يُخزَّن.