Check-Host.cc

وثائق الـ API

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

لماذا هذا؟

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

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

Send the key as an Authorization: Bearer <key> header — the code samples below fill this in for you. For backward compatibility an apikey field in a POST body is still accepted; passing it in the URL query string is not.

الخصوصية: يبقى المفتاح فقط في 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 .

الاستعلامات

8 نقطة نهاية

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

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

12 نقطة نهاية

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

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

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

Network Intelligence

3 نقطة نهاية

Dispatch deep, multi-stage scans (port + banner + body + TLS + threat-intel) of an IP, CIDR, domain or ASN. Asynchronous: submit, then poll the status endpoint. Open to guests, with per-IP and per-target hourly quotas.

Intelligence Data

8 نقطة نهاية

Read the aggregated intelligence we already hold for an entity — the same data that powers the /ip, /as, /domain … pages, as JSON. Open to guests with a per-IP rate limit; an API key lifts the limits.

Geo Intelligence

4 نقطة نهاية

Country, TLD and continent-level aggregates plus the global threat feed — the same data that powers the /country, /tld, /continent and /threats pages, as JSON. Open to guests with a per-IP rate limit; an API key lifts the limits.

التقارير

3 نقطة نهاية

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