SmartKitio

مواضيع المطوّر · آخر تحديث 2026-10-04

شرح رموز حالة HTTP

كل استجابة HTTP تحمل رمز حالة من ثلاثة أرقام. الرقم الأول هو الفئة؛ والباقي يسمّي النتيجة المحددة. قراءة الفئة بسرعة تخبرك إن كان عليك إعادة المحاولة أو اتباع إعادة توجيه أو إصلاح الطلب أو فحص الخادم.

الفئات بنظرة سريعة

فئات رموز الحالة

النطاقالمعنىإجراء العميل المعتاد
1xxإعلاميانتظر الاستجابة التالية
2xxنجاحاستخدم الجسم / عدّ الطلب منجزاً
3xxإعادة توجيهاتبع Location حين يكون ذلك مناسباً
4xxخطأ من العميلأصلح الطلب أو بيانات الاعتماد
5xxخطأ من الخادمأعد المحاولة بإمهال متزايد أو نبّه فريق التشغيل

رموز ستراها باستمرار

  • 200 OK — نجح الطلب.
  • 201 Created — أُنشئ مورد جديد.
  • 204 No Content — نجاح بجسم فارغ.
  • 301 Moved Permanently / 302 Found — إعادة توجيه؛ يختلف التخزين المؤقت والتعامل مع الطريقة.
  • 304 Not Modified — النسخة المخزّنة ما زالت صالحة.
  • 400 Bad Request — صياغة مشوّهة أو تأطير غير صالح.
  • 401 Unauthorized — المصادقة مطلوبة أو فشلت.
  • 403 Forbidden — مصادَق لكن غير مسموح.
  • 404 Not Found — لا مورد عند هذا الهدف.
  • 409 Conflict — تعارض في الحالة (شائع في واجهات API).
  • 429 Too Many Requests — حد للمعدل؛ احترم Retry-After حين يوجد.
  • 500 Internal Server Error — فشل غير متوقع في الخادم.
  • 502 Bad Gateway / 503 Service Unavailable — عطل في الخادم الأعلى أو انقطاع مؤقت.

نصائح عملية

  • لا تعامل كل ما ليس 200 فشلاً قاطعاً — قد تكون 3xx طبيعية.
  • سجّل الحالة والرابط ومعرّف الارتباط معاً عند التنقيح.
  • لواجهات API، اقرأ جسم الاستجابة؛ كثير من التطبيقات تضع هناك تفاصيل الخطأ القابلة للقراءة آلياً.

يسرد بحث حالة HTTP في SmartKitio الرموز وشروحاً قصيرة للرجوع إليها أثناء التنقيح. وهو لا يرسل طلبات إلى خوادمك.

جرّب هذه الأدوات

استخدم أداة للنتيجة؛ أبقِ الدليل مفتوحاً للطريقة.

تصفح العائلة: أدوات المطوّر

مقالات ذات صلة

قراءات أوسع ترتبط بهذا الدليل — عندما يستحق الموضوع أكثر من شرح عملي.

أدلة ذات صلة