Check-Host.cc

API دستاویز

دنیا بھر کے 65+ نوڈز سے تقسیم شدہ نیٹ ورک تشخیص — Ping، MTR، DNS، HTTP، TCP اور UDP — اور ساتھ میں ہوسٹ میٹا ڈیٹا، WHOIS اور پرانی رپورٹس۔ نیچے ہر اینڈ پوائنٹ قابلِ ترمیم ہے اور براؤزر سے ہی لائیو API پر چلایا جا سکتا ہے۔

SDK
Node.js
SDK
Python
SDK
PHP 8.1+
SDK
Go
SDK
Java
یہ کس لیے ہے؟

زیادہ تر صورتوں میں گمنام استعمال کافی ہے۔ فی 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 اینڈ پوائنٹس

دنیا بھر کے 65+ نوڈز سے Ping / TCP / UDP / HTTP / DNS / MTR چیک بھیجیں — ہر کال UUID لوٹاتی ہے، پھر نتائج کے لیے /report/{uuid} پر خودکار پولنگ کرتی ہے۔

تیز GET شارٹ کٹس

سادہ چیکس کے لیے فوری URLs — نہ علاقائی انتخاب، نہ Live موڈ (ان کے لیے اوپر 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 رپورٹ یا اسٹیٹس کی رینڈرڈ تصاویر حاصل کریں۔