ForHosting KIT · قراءة المواقع ومراقبتها

البحث عن رمز حالة HTTP

رمز حالة HTTP موجز، لكن الرقم وحده لا يكون سهل التذكر دائمًا. يحوّل هذا البحث أي رمز من 100 إلى 599 إلى عبارته القياسية وفئته العامة: معلومات أو نجاح أو إعادة توجيه أو خطأ من العميل أو خطأ من الخادم.

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

شغّل الأداة مجانًا اطّلع على الـAPI

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

يفيدكم عند قراءة السجلات، وتصحيح تكامل، ومراجعة تنبيهات المراقبة، وشرح استجابة API. النتيجة حتمية ولا تتطلب أي طلب شبكي، كما تميّز بوضوح الرموز الصحيحة ضمن النطاق التي لم تُسند إليها عبارة قياسية بعد.

اقرؤوا رمز الاستجابة من دون تعطيل سير العمل

تضع استجابات HTTP رمز حالة من ثلاثة أرقام في بداية البيانات الوصفية للبروتوكول. وعندما يظهر الرمز في سطر سجل، أو تقرير تسليم webhook، أو وحدة تحكم المتصفح، أو تتبع وكيل عكسي، أو استثناء عميل API، يعرض هذا البحث تسمية مفهومة فورًا. أدخلوا عددًا صحيحًا بين 100 و599. تكرر النتيجة الرمز بعد توحيده، وتعرض عبارته المسجلة أو الشائعة في المعايير، وتحدد الفئة التي يمثلها الرقم الأول. فعلى سبيل المثال، يقابل 404 العبارة “Not Found” وفئة خطأ العميل، بينما يقابل 503 العبارة “Service Unavailable” وفئة خطأ الخادم. هذه أداة مرجعية وليست طلب HTTP؛ فهي لا تتصل بالموقع المعني، ولا تختبر سلامة endpoint، ولا تستنتج سبب استجابة بعينها. لذلك تبقى المخرجات ثابتة وآمنة للاستخدام في الوثائق وأدوات الدعم ونصوص سطر الأوامر وإثراء السجلات والواجهات التعليمية، من دون إضافة زمن شبكة أو كشف URL خاص.

افهموا الفئات والقيم غير المسندة

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

استخدموا النتيجة بطريقة صحيحة في التصحيح والأتمتة

عبارة السبب تسمية موجزة وليست تشخيصًا. إذا أعادت API الرمز 401 Unauthorized، فإن العبارة تحدد دلالة الاستجابة، لكن العلاج الفعلي قد يكون إضافة رمز مصادقة، أو تجديد جلسة منتهية، أو تصحيح توقيع، أو مراجعة سياسة موضحة في متن الاستجابة. وبالمثل، يشير 500 Internal Server Error إلى عطل من جهة الخادم من دون كشف المكوّن الذي تعطل. استخدموا هذا البحث خطوة أولى للتفسير، ثم افحصوا الترويسات والمتن وطريقة الطلب وإرشادات إعادة المحاولة ووثائق الخدمة. في الأتمتة تكون الفئة غالبًا أكثر ثباتًا من العبارة؛ إذ يمكن لقاعدة مراقبة جمع كل استجابات 500–599 ضمن أخطاء الخادم، بينما تعرض الواجهة العبارة الدقيقة للمستخدم. وعندما يلزم سلوك دقيق، ينبغي للبرنامج الاعتماد على الرمز الرقمي. تبلغ تكلفة طلب API واحد $0.002، وتُعاد حقول JSON صغيرة ملائمة للتخزين أو العرض المباشر. ولأن الحساب محلي وحتمي، ينتج الإدخال نفسه المخرجات نفسها دائمًا.

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

تفسير سجلات التطبيقات

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

إثراء تنبيهات المراقبة

أضيفوا عبارة ثابتة وفئة للخطأ قبل وصول التنبيه إلى المهندس المناوب.

شرح سلوك API

قدّموا إلى فرق التطوير والدعم معنى معياريًا موجزًا لرمز الاستجابة في الوثائق أو التذاكر.

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

ما نوع الإدخال الذي يقبله البحث؟

أدخلوا رمز حالة HTTP صحيحًا من 100 إلى 599. تعيد القيم خارج النطاق والأعداد غير الصحيحة خطأ إدخال غير صالح.

ماذا يحدث إذا كان الرمز ضمن النطاق من دون عبارة قياسية؟

تُعاد عبارة «غير مسند»، بينما يستمر اشتقاق الفئة من الرقم الأول.

هل ترسل هذه الأداة طلبًا إلى موقع ويب؟

لا. إنها تنفذ بحثًا محليًا حتميًا ولا تتصل بأي URL أو خدمة خارجية.

هل تشرح العبارة السبب الجذري للخطأ؟

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

ما تكلفة البحث عبر API؟

تبلغ تكلفة كل طلب API مقدار $0.002. أما إصدار المتصفح فيعمل محليًا مجانًا.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/web/http-status-lookup

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

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

curl -X POST https://api.kit.forhosting.com/web/http-status-lookup \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"code":404}'

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

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/web/http-status-lookup",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "code": 404
},
)
task_id = res.json()["task_id"]

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

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

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

{
  "code": 404
}

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

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

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

الأسعار

لكل طلب$0.002

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

الحدود

`timeout_sec`	30
`max_crawl_pages`	25

الأخطاء

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

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