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.

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.

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

7 endpoint

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

Küresel Kontroller

11 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).

Raporlar

3 endpoint

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