API Belgeleri — GetDNS

Kimlik doğrulama

Her istek token'ınızı Bearer token olarak içermelidir:

curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://getdns.com.tr/api/public/v1/ip/8.8.8.8

Geçerli token'ı olmayan istekler 401 alır. Devre dışı bırakılmış bir hesaptan gelen istekler ve (varsa ve hesap sayfanızdan yönettiğiniz) hesabınızın izin verilen IP listesi dışındaki bir IP adresinden gelen istekler 403 alır. Her hesabın kendi dakika başına istek sınırı vardır; aşıldığında 429 döner ve Retry-After ile bir X-RateLimit-Limit / X-RateLimit-Remaining yanıt başlığı çifti gelir.

GET /api/public/v1/dns/{domain}/{type}

Bir alan adı için tek bir DNS kayıt türünü sorgulayın.

curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://getdns.com.tr/api/public/v1/dns/example.com/A

GET /api/public/v1/ip/{ip}

Bir IPv4 veya IPv6 adresi için ülke, şehir, ISP ve ASN bilgisini sorgulayın. Özel, loopback ve diğer herkese açık olmayan adresler sorgulanmaz: yanıt bunun yerine adresi açıklayan bir special nesnesi taşır.

curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://getdns.com.tr/api/public/v1/ip/8.8.8.8

POST /api/public/v1/ip

Tek istekte en fazla 30 IP adresi sorgulayın. ips dizisi içeren bir JSON gövdesi gönderin. Sonuçlar girdi sırasıyla ve yinelenenler çıkarılarak döner; geçersiz bir adres yalnızca kendi satırını başarısız kılar ("status": "error"). 30'dan fazla adres 422 döndürür. Özel, loopback ve diğer herkese açık olmayan adresler konum verisi yerine bir special nesnesiyle döner.

curl -X POST \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"ips":["8.8.8.8","1.1.1.1"]}' \
  https://getdns.com.tr/api/public/v1/ip

GET /api/public/v1/asn/{asn}

Bir Otonom Sistem Numarası tarafından duyurulan ağ bloklarını sorgulayın.

curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://getdns.com.tr/api/public/v1/asn/AS15169

GET /api/public/v1/ssl?hostname=&port=

Bir hostname ve port için SSL/TLS sertifikasını inceleyin (port varsayılanı 443'tür).

curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://getdns.com.tr/api/public/v1/ssl?hostname=example.com&port=443"

Tüm yanıtlar bir status alanı ("ok" veya "error") içeren JSON'dur. Sorguladığınız alan adı, IP veya ASN asla saklanmaz — yalnızca hesap başına toplam günlük istek sayısını tutarız. Gizlilik sayfamıza bakın.

Token gerekmez

Bu iki uç nokta kendi IP adresinizi düz metin olarak döndürür — hesap yok, token yok, JSON ayrıştırma gerekmez.

GET /ip.txt

Hangi protokolle bağlandıysanız, IP adresiniz.

curl https://getdns.com.tr/ip.txt

GET /ipv6.txt

IPv6 adresiniz; yalnızca IPv6 ile bağlandıysanız — aksi halde boş yanıt.

curl https://getdns.com.tr/ipv6.txt

Postman koleksiyonu

Bu sayfadaki tüm uç noktalar için Postman koleksiyonunu indirin; içe aktarmaya hazır.

Genel API