Check-Host.cc

وثائق الـ API

تشخيص شبكي موزَّع من أكثر من 65 عقدة عالمية — Ping و MTR و DNS و HTTP و TCP و UDP — بالإضافة إلى بيانات المضيف الوصفية و WHOIS والتقارير السابقة. كل نقطة نهاية في الأسفل قابلة للتعديل والتشغيل من المتصفح مباشرةً على الـ API الحي.

لماذا هذا؟

الاستخدام المجهول يكفي في معظم الحالات. توجد حدود استخدام معتدلة لكل عنوان IP ولكل هدف — راجع الجدول الكامل في /about إن احتجت الأرقام الدقيقة.

يرفع مفتاح الـ API (بصيغة UUID) هذه الحدود مع حصة شهرية لكل مفتاح. المفاتيح مجانية — Check-Host مشروع غير ربحي والحدود موجودة فقط لمنع إساءة الاستخدام، لا للربح. إن كان لديك استخدام مشروع يتجاوز المستوى المجهول، تواصل مع الدعم.

الخصوصية: يبقى المفتاح فقط في localStorage للمتصفح في هذه الصفحة، ولا يُرسَل إلا إلى api.check-host.cc.

البدء السريع

إرسال الفحص غير متزامن: (1) أرسل POST إلى نقطة نهاية مراقبة لتحصل على UUID، (2) ثم استعلم عن /report/{uuid} حتى تستجيب كل عقدة. تنتهي معظم الفحوصات خلال 1–10 ثوانٍ. نقاط النهاية في الأسفل تقوم بالاستعلام تلقائيًا حين تنقر تشغيل.

نمط الاستعلام (bash)
# 1. Dispatch a check, capture the UUID
UUID=$(curl -s -X POST https://api.check-host.cc/ping \
  -H 'Content-Type: application/json' \
  -d '{"target":"check-host.cc","region":["DE"]}' | jq -r .uuid)

# 2. Poll until at least one node has reported
until curl -s "https://api.check-host.cc/report/$UUID" \
  | jq -e '.data | length >= 1' > /dev/null; do sleep 1; done

curl -s "https://api.check-host.cc/report/$UUID" | jq .

الاستعلامات

7 نقطة نهاية

IP، الموقع الجغرافي، WHOIS، وقائمة العقد الحية.

فحوصات عالمية

11 نقطة نهاية

أرسل فحص Ping / TCP / UDP / HTTP / DNS / MTR من أكثر من 65 عقدة عالمية — كل استدعاء يُرجع UUID ثم يستعلم تلقائيًا عن /report/{uuid} للنتائج.

اختصارات GET سريعة

روابط جاهزة للفحوصات البسيطة — بلا استهداف منطقة ولا الوضع المباشر (استعمل POST في الأعلى لذلك).

التقارير

3 نقطة نهاية

استرجع تقرير JSON أو صور الحالة المُولَّدة لفحص سبق إرساله.