Check-Host.cc

API दस्तावेज़

65+ वैश्विक नोड्स से वितरित नेटवर्क डायग्नोस्टिक्स — Ping, MTR, DNS, HTTP, TCP और UDP — साथ में होस्ट मेटाडेटा, WHOIS और पुराने चेक रिपोर्ट्स। नीचे का हर एंडपॉइंट एडिटेबल है और लाइव API के ख़िलाफ़ ब्राउज़र में ही चलाया जा सकता है।

यह किसके लिए है?

ज़्यादातर मामलों में अनाम (anonymous) काम कर जाता है। प्रति-IP और प्रति-टार्गेट संयमित रेट लिमिट्स लागू होते हैं — सटीक संख्याओं के लिए /about की पूरी तालिका देखें।

API कुंजी (UUID फॉर्मैट) इन सीमाओं को बढ़ाती है और प्रति-कुंजी मासिक कोटा देती है। कुंजियाँ निःशुल्क हैं — Check-Host एक ग़ैर-लाभकारी प्रोजेक्ट है, और सीमाएँ केवल दुरुपयोग रोकने के लिए हैं, कमाई के लिए नहीं। अगर आपका वैध उपयोग anonymous स्तर से आगे जाता है, तो सपोर्ट से सम्पर्क करें

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 शॉर्टकट

आसान चेक के लिए तैयार URL — कोई क्षेत्र लक्ष्यण नहीं, कोई 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 रिपोर्ट या रेंडर की हुई स्टेटस इमेज लाएँ।