ForHosting KIT · أدوات المطورين

قائمة رموز حالة HTTP حسب الفئة

اختر فئة من فئات استجابات HTTP لتحصل على قائمة كاملة ومرتبة بالرموز القياسية المسجلة فيها مع عبارات السبب الخاصة بها.

● Betaمجاني · داخل متصفحك

استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

الفئات الخمس المدعومة هي المعلومات والنجاح وإعادة التوجيه وخطأ العميل وخطأ الخادم، وهي تقابل الفئات من 1xx إلى 5xx. تعرض النتيجة أيضا المجال العددي وعدد العناصر، ولذلك يمكنكم استخدامها في التوثيق والاختبارات وأدوات المطورين والمراجعة السريعة للبروتوكول من دون إرسال طلب عبر الشبكة أو فحص خادم يعمل فعليا.

اختاروا إحدى فئات استجابات HTTP الخمس

تجمع رموز حالة HTTP وفقا للرقم الأول. تقع الاستجابات المعلوماتية في المجال 100–199 وتصف تقدما مؤقتا قبل الاستجابة النهائية. تستخدم استجابات النجاح المجال 200–299 وتدل على أن الطلب استلم أو فهم أو أنجز بالطريقة التي يحددها الرمز المعني. تستخدم عمليات إعادة التوجيه المجال 300–399 لاختيار الموارد وتغيير المواقع والتحقق من ذاكرة التخزين المؤقت وقرارات التوجيه المرتبطة بذلك. تستخدم أخطاء العميل المجال 400–499 عندما يتعذر تنفيذ الطلب بسبب بنيته أو بيانات اعتماده أو شروطه المسبقة أو وجهته أو معدله أو ظرف آخر من جهة العميل. تستخدم أخطاء الخادم المجال 500–599 عندما يعجز الخادم أو الوسيط عن إكمال طلب يبدو صالحا. أدخلوا فئة واحدة لتحصلوا على اسمها القياسي ومجالها العددي وعدد عناصرها ومصفوفة `statuses` مرتبة تصاعديا. تتجاهل المطابقة حالة الأحرف والمسافات المحيطة والشرطات والشرطات السفلية. أما التسميات الأخرى فترفض برسالة واضحة بدلا من تخمين المقصود منها.

اقرؤوا الرموز وعبارات السبب بدقة

يحتوي كل عنصر في المصفوفة على `code` عددي و`reason_phrase` قياسية. العبارة تسمية اصطلاحية موجزة وليست شرحا كاملا للوقت الذي ينبغي فيه إنشاء الاستجابة. فعلى سبيل المثال، يحدد 404 Not Found النتيجة، بينما تحدد مواصفة HTTP المعنية سلوك التخزين المؤقت والتفاعل مع الأساليب ودلالات التمثيل. تستخدم صياغة السجل الحديثة حين تختلف عنها المراجع القديمة: فالرمز 413 هو Content Too Large والرمز 422 هو Unprocessable Content. يدرج الرمز 418 بتسمية السجل Unused؛ أما عبارة إبريق الشاي المعروفة فمصدرها مواصفة تجريبية سابقة، ولا ينبغي اعتبارها العنوان الحالي في السجل الأساسي. تحذف الفجوات غير المسجلة عمدا، ولذلك لا تحتوي الفئة بالضرورة على كل عدد صحيح ضمن مجالها. ترتب القائمة عدديا كي تتمكنوا من عرض الجداول مباشرة أو مقارنة الرموز المعتمدة أو إنشاء أداة اختيار من دون فرز إضافي. عبارات السبب بيانات وصفية؛ فلا ينقل HTTP/2 ولا HTTP/3 حقلا لعبارة السبب، وينبغي أن تعتمد برامج العملاء على الرمز العددي في اتخاذ القرار.

استخدموا النتيجة في التوثيق والتحقق

تفيد هذه القدرة عندما تحتاج الأداة إلى مجموعة مرجعية محدودة بدلا من تفاصيل استجابة حية بعينها. يستطيع مولد التوثيق طلب كل فئة وإنشاء جداول متناسقة. وتستطيع حزمة الاختبارات التأكد من أن التطبيق يصدر رمزا مسجلا ضمن الفئة المتوقعة، مع تطبيق قواعدها الخاصة بشأن الاستجابات التي يسمح بها كل endpoint. كما يستطيع مستكشف API ملء قائمة مجمعة بعبارات السبب المعادة، ويمكن للمواد التعليمية أن تقارن بين النتائج المؤقتة والناجحة ونتائج إعادة التوجيه وأخطاء العميل وأخطاء الخادم. تعتمد العملية على بحث ثابت في الذاكرة؛ فهي لا ترسل طلبات شبكية ولا تقرأ حالة الخادم ولا تخزن المدخلات، وتنتج النتيجة نفسها للفئة المطبعة نفسها. ولا تحكم على ملاءمة رمز لحالة عمل محددة، ولا تضيف رموز الموردين، ولا تفسر جسم الاستجابة. ولأن السجلات قد تتطور عند إضافة مواصفات جديدة، ينبغي لمن يحتاج إلى مرجع ملزم قانونيا أو تشغيليا أن يحتفظ أيضا بإصدار المواصفة المعتمد في مشروعه. يشترك المتصفح وAPI في المحلل الحتمي نفسه، وتبلغ كلفة استدعاء API مقدار $0.002.

حالات الاستخدام

إنشاء جداول توثيق API

أنشئوا جدولا مرجعيا مرتبا لفئة استجابة واحدة، يتضمن رموزا عددية وعبارات سبب متناسقة.

التحقق من سياسات الاستجابة

قارنوا الاستجابات التي يسمح بها التطبيق بالرموز المسجلة ضمن فئة HTTP المقصودة.

تزويد أدوات المطورين بالبيانات

املؤوا أدوات الاختيار المجمعة والمراجع السريعة وواجهات التعلم من نتيجة منظمة وحتمية.

الأسئلة الشائعة

ما أسماء الفئات المقبولة؟

استخدموا informational أو success أو redirect أو client error أو server error. لا تتأثر المطابقة بحالة الأحرف، وتقبل الشرطات أو الشرطات السفلية في الأسماء المركبة.

هل تشمل القائمة كل الأرقام ضمن المجال؟

لا. فهي تشمل الرموز القياسية المسجلة وتحذف الفجوات غير المسجلة ضمن مجالات 1xx و2xx و3xx و4xx و5xx.

لماذا يحمل الرمز 418 تسمية Unused؟

يحجز سجل HTTP الأساسي الحالي الرمز 418 تحت تسمية Unused. أما الإشارة المعروفة إلى إبريق الشاي فمصدرها مواصفة تجريبية.

هل يمكن فحص عنوان URL يعمل فعليا؟

لا. هذه أداة مرجعية حتمية لا ترسل طلبات شبكية. استخدموا قدرة لفحص HTTP إذا أردتم تحليل endpoint يعمل فعليا.

هل تنقل جميع إصدارات HTTP عبارات السبب؟

لا. إنها تسميات اصطلاحية، ولا ينقل HTTP/2 أو HTTP/3 حقلا لعبارة السبب. ينبغي أن يعتمد منطق البرنامج على الرمز العددي.

للمطوّرين — الوصول عبر API

كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.

الـEndpoint

POSThttps://api.kit.forhosting.com/dev2/http-status-by-category

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

استدعِ الخدمة من بيئتك

curl -X POST https://api.kit.forhosting.com/dev2/http-status-by-category \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"client error"}'

const res = await fetch("https://api.kit.forhosting.com/dev2/http-status-by-category", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "category": "client error"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/dev2/http-status-by-category",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "category": "client error"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/dev2/http-status-by-category", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"category":"client error"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"category":"client error"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/dev2/http-status-by-category", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

مثال على الطلب

{
  "category": "client error"
}

مثال على الاستجابة

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "dev2.http_status_by_category",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

اطّلع على توثيق KIT الكامل ←