Check-Host.cc

API Dokümantasyonu

65+ küresel düğümden dağıtık ağ tanılaması — Ping, MTR, DNS, HTTP, TCP ve UDP — artı host meta verileri, WHOIS ve geçmiş kontrol raporları. Aşağıdaki her endpoint düzenlenebilir ve canlı API'ye karşı tarayıcıdan çalıştırılabilir.

SDK
Node.js
SDK
Python
SDK
PHP 8.1+
SDK
Go
SDK
Java
Bu ne işe yarar?

Anonim kullanım çoğu durumda yeter. IP başına ve hedef başına makul rate-limit'ler uygulanır — kesin rakamlar için /about'taki tam tabloya bakın.

API anahtarı (UUID formatında) bu limitleri anahtar başına aylık kotayla yükseltir. Anahtarlar ücretsizdir — Check-Host kâr amacı gütmeyen bir projedir, limitler yalnızca kötüye kullanımı önlemek için var, gelir için değil. Anonim seviyeyi aşan meşru bir kullanımınız varsa destek ekibine yazın.

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.

Gizlilik: anahtar yalnızca tarayıcınızın bu sayfadaki localStorage'ında durur ve sadece api.check-host.cc'ye gönderilir.

Hızlı başlangıç

Kontrol göndermek asenkrondur: (1) monitoring endpoint'ine POST atın, UUID alın, (2) her düğüm rapor edene kadar /report/{uuid}'i sorgulayın. Çoğu kontrol 1–10 saniyede biter. Aşağıdaki endpoint'ler Çalıştır'a bastığınızda bunu sizin için yapar.

Polling örüntüsü (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 .

Sorgular

8 endpoint

IP, coğrafi konum, WHOIS ve canlı düğüm listesi.

Küresel Kontroller

12 endpoint

65+ küresel düğümden Ping / TCP / UDP / HTTP / DNS / MTR kontrolü gönderin — her çağrı bir UUID döndürür ve sonuçlar için /report/{uuid}'i otomatik sorgular.

Hızlı GET kısayolları

Basit kontroller için kullanıma hazır URL'ler — bölge hedefleme ve Live Mode yok (onlar için yukarıdaki POST'u kullanın).

Network Intelligence

3 endpoint

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 endpoint

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 endpoint

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.

Raporlar

3 endpoint

Daha önce gönderilen bir kontrolün JSON raporunu veya render edilmiş durum görsellerini alın.