مواضيع المطوّر · آخر تحديث 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 الرموز وشروحاً قصيرة للرجوع إليها أثناء التنقيح. وهو لا يرسل طلبات إلى خوادمك.
جرّب هذه الأدوات
استخدم أداة للنتيجة؛ أبقِ الدليل مفتوحاً للطريقة.
تصفح العائلة: أدوات المطوّر
مقالات ذات صلة
قراءات أوسع ترتبط بهذا الدليل — عندما يستحق الموضوع أكثر من شرح عملي.
- كيف يعمل متصفّح الويب فعلياً
من كتابة الرابط إلى رسم البكسلات — ما الذي يفعله المتصفّح خلف شريط العنوان الهادئ.
- كيف تقرأ الوثائق التقنية بفعالية
قراءة موجّهة بالهدف لمراجع API، دروس، auth، أخطاء، وchangelogs — عادات تحقق، استخدام معقول للذكاء الاصطناعي، وأدوات حين تصبح حمولات JSON ثقيلة.
- ماذا يحدث حين تُدخل رابطاً؟
مسار خطوة بخطوة من ضغطة المفتاح إلى أول رسم، يشمل DNS وTLS وإعادات التوجيه والتخزين المؤقت.
- ما هي واجهة البرمجة (API) وكيف تعمل؟
واجهات البرمجة عقود بين البرامج. واجهات HTTP JSON هي الوجه الأبرز — الطرق والترويسات والأجسام ورموز الحالة والمصادقة وإصدارات الواجهة موضّحة هنا.
أدلة ذات صلة
- شرح ترميز الروابط
الترميز المئوي لقيم الاستعلام، وما يغيّره encodeURIComponent، والمزالق الشائعة.
- تنسيق JSON والتحقق منه: دليل كامل
ما يسمح به JSON الصارم، وكيف يعمل التنسيق الجميل، وكيف يتصرف منسّق SmartKitio.
- JSON مقابل JSON5: ما الفرق؟
لماذا يبدو JSON5 أسهل عند الكتابة، ولماذا ما زالت واجهات الإنتاج توحّد على JSON الصارم.
- شرح ترميز Base64
كيف يربط Base64 البايتات بـ ASCII، ولماذا يزداد الطول، وكيف يرمّز SmartKitio نص UTF-8.

