dnssorgulama.com
Geliştirici

API Dokümantasyonu

Sitedeki tüm analizler REST üzerinden JSON olarak alınabilir. Aynı motor, aynı önbellek, aynı sonuçlar.

Kimlik doğrulama

Her istek bir API anahtarı taşımalıdır. Anahtarı panelinizden oluşturabilirsiniz.

curl -H "X-API-Key: dns_xxxxxxxxxxxxxxxxxxxxxxxx" \ https://dnssorgulama.com/api/v1/dns/example.com

Alternatif olarak Authorization: Bearer dns_... başlığı da kabul edilir.

Yanıt biçimi

{ "ok": true, "data": { ... }, "meta": { "domain": "example.com", "endpoint": "dns", "duration_ms": 184, "cached": false, "generated_at": "2026-08-22T00:45:25+03:00", "rate_limit": { "limit": 100, "remaining": 99, "reset": 1787352325 } } }

Hatalarda ok: false döner ve error.code alanı makine tarafından okunabilir bir kod içerir: unauthorized, invalid_domain, rate_limited, unknown_endpoint, server_error.

Uç noktalar

Uç noktaAçıklama
/api/v1/dns/{domain} Tüm DNS kayıtları
A, AAAA, CNAME, MX, NS, TXT, SOA, SRV ve CAA kayıtlarını TTL değerleriyle döndürür.
/api/v1/whois/{domain} Kayıt bilgileri
RDAP öncelikli; tescil firması, tarihler, durum kodları ve ad sunucuları.
/api/v1/ssl/{domain} TLS sertifikası
Zincir, SAN listesi, protokol, anahtar gücü ve not.
/api/v1/http/{domain} HTTP yanıtı
Yönlendirme zinciri, süreler, başlıklar ve sunucu bilgisi.
/api/v1/security/{domain} Güvenlik başlıkları
HSTS, CSP, X-Frame-Options ve diğerleri; puanlı.
/api/v1/mail/{domain} E-posta güvenliği
MX, SPF (sorgu sayısı dahil), DKIM, DMARC, BIMI, MTA-STS, TLS-RPT.
/api/v1/dnssec/{domain} DNSSEC
DS, DNSKEY, doğrulama durumu ve algoritma bilgisi.
/api/v1/ip/{domain} IP ve ASN
Ters DNS, ASN sahibi, ağ bloğu ve tahsis bilgisi.
/api/v1/cdn/{domain} CDN / WAF
Kanıt listesiyle birlikte tespit.
/api/v1/tech/{domain} Teknoloji tespiti
CMS, çatı, analitik ve ödeme altyapısı.
/api/v1/trace/{domain} DNS zinciri
Kökten yetkili sunucuya adım adım süreler.
/api/v1/propagation/{domain} Küresel yayılım
15 çözümleyicinin yanıtları.
/api/v1/analyze/{domain} Tam analiz
Tüm modüller + sağlık puanı + bulgular.
/api/v1/ports/{domain} Port kontrolü
Standart servis portları.
/api/v1/blacklist/{domain} Kara liste
DNSBL kontrolleri.
/api/v1/subdomain/{domain} Alt alan adları
Sertifika şeffaflık günlüklerinden.
/api/v1/valuation/{domain} Değerlendirme
Algoritmik alan adı puanı.

Ek parametreler

  • ?type=A — trace ve propagation uçlarında kayıt tipi.

Durum ve kota

GET /api/v1/status anahtarınızın planını ve kalan kotanızı döndürür. Her yanıtta X-RateLimit-Limit, X-RateLimit-Remaining ve X-RateLimit-Reset başlıkları bulunur.

Örnek: sağlık puanı

curl -s -H "X-API-Key: $KEY" \ https://dnssorgulama.com/api/v1/analyze/example.com \ | jq '.data.score.score, .data.analysis.summary'

Kurallar

  • Yanıtlar önbellekten gelebilir; meta.cached alanı bunu belirtir.
  • Kota aşımında 429 ve Retry-After başlığı döner.
  • Yalnızca herkese açık DNS ve HTTP verisi sorgulanır; özel ağ adresleri reddedilir.
  • Veri sağlayıcısı gerektiren uçlar (performans, pasif DNS) yapılandırılmamışsa configured: false döner — uydurma veri üretilmez.