Geliştirici API

Her araca REST üzerinden programatik erişim. Tüm uç noktalar aynı JSON zarfını döner — başarıda { ok: true, data, meta }, hatada { ok: false, error }. HTTP durum kodu her zaman ok alanıyla tutarlıdır.

Kimlik Doğrulama

Kimlik doğrulama isteğe bağlıdır. Anahtarsız istekler istemci IP'si üzerinden sayılır ve dakikada 15 sorguyla sınırlıdır. Daha yüksek limit için İzleme panelinden bir API anahtarı oluşturun ve her istekte X-API-Key başlığında gönderin.

Erişim	Limit	Not
Anonim	15 / dk	IP başına — anahtar gerekmez
API anahtarı	Daha yüksek	Anahtar başına — plana göre

Her yanıt X-RateLimit-Limit ve X-RateLimit-Remaining başlıklarını taşır. Limit aşıldığında 429 döner ve gövdedeki retryMs alanı, pencerenin ne kadar sonra sıfırlanacağını milisaniye cinsinden verir.

curl -H "X-API-Key: nt_xxx" \
  "/api/v1/dns?domain=example.com&type=MX"

Uç Noktalar10

Metot	Path	Açıklama
GET	/api/v1/dns?domain=example.com&type=MX	DNS kayıtları
GET	/api/v1/ssl?host=example.com	SSL sertifikası
GET	/api/v1/whois?domain=example.com	WHOIS bilgisi
GET	/api/v1/ip?ip=8.8.8.8	IP geolocation
GET	/api/v1/blacklist?ip=8.8.8.8	Blacklist kontrolü
GET	/api/v1/asn?query=AS15169	ASN / BGP
GET	/api/v1/email-security?domain=example.com	SPF/DKIM/DMARC
GET	/api/v1/subnet?cidr=192.168.1.0/24	Subnet hesap
POST	/api/v1/report	Birleşik domain raporu
POST	/api/v1/bulk/report	Toplu rapor (max 25)

Yanıt Zarfı

{
  "ok": true,
  "data": {
    "resolver": "Google (8.8.8.8)",
    "records": { "MX": [{ "data": "10 mail.example.com", "TTL": 3600 }] }
  },
  "meta": { "cached": false, "plan": "free" }
}

ok: İsteğin başarılı olup olmadığı. false olduğunda data ve meta yerine error alanı gelir.
data: Uç noktaya özgü sonuç gövdesi — yalnızca ok:true yanıtlarında bulunur.
meta: İstek hakkında yan bilgi: cached (önbellekten mi geldi), plan (anon veya anahtarın planı), tookMs, toplu isteklerde count.

Hatalar

Başarısız istekler aynı zarfın hata biçimini döner: ok her zaman false, error ise insan tarafından okunabilir bir mesajdır. Bazı hatalar ek alanlar taşır — örneğin 429 yanıtı plan ve retryMs ekler.

{
  "ok": false,
  "error": "Rate limit aşıldı",
  "plan": "anon",
  "retryMs": 41230
}

Durum Kodları

Kod	Anlam	Ne zaman	Ek alan
200	OK	Başarılı yanıt — ok:true	—
204	No Content	OPTIONS ön kontrolü (CORS) — gövde yok	—
400	Bad Request	Eksik veya geçersiz parametre	—
401	Unauthorized	Oturum gerektiren panel uçları (/api/monitors, /api/keys)	—
404	Not Found	Bilinmeyen uç nokta veya kayıt	—
429	Too Many Requests	Dakikalık limit aşıldı	plan, retryMs
502	Bad Gateway	Yukarı akış sorgusu başarısız oldu	—

Toplu Rapor

Tek istekte en fazla 25 hedef işlenir; fazlası sessizce kırpılır. Her hedef bağımsız değerlendirilir, biri başarısız olsa da yanıt 200 döner — hedef bazlı sonucu data[].ok alanından kontrol edin.

curl -X POST -H "X-API-Key: nt_xxx" -H "content-type: application/json" \
  -d '{"targets":["example.com","google.com"]}' \
  /api/v1/bulk/report