API dokumentacija

Autentifikacija

Svaki zahtev mora da sadrži vaš token kao Bearer token:

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

Zahtevi bez važećeg tokena dobijaju 401. Zahtevi sa onemogućenog naloga dobijaju 403, kao i zahtevi sa IP adrese van dozvoljene IP liste vašeg naloga (ako ste je podesili — upravljajte njome sa stranice naloga). Svaki nalog ima sopstveno ograničenje po minutu; prekoračenje vraća 429 uz Retry-After i par zaglavlja odgovora X-RateLimit-Limit / X-RateLimit-Remaining.

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

Upitajte jedan tip DNS zapisa za domen.

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

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

Saznajte zemlju, grad, ISP i ASN za IPv4 ili IPv6 adresu. Privatne, loopback i druge nejavne adrese se ne pretražuju: odgovor umesto toga sadrži special objekat koji opisuje adresu.

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

POST /api/public/v1/ip

Pretražite do 30 IP adresa u jednom zahtevu. Pošaljite JSON telo sa nizom ips. Rezultati se vraćaju redosledom unosa uz uklonjene duplikate; neispravna adresa obara samo svoj red ("status": "error"). Više od 30 adresa vraća 422. Privatne, loopback i druge nejavne adrese vraćaju se sa special objektom umesto podataka o lokaciji.

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}

Pretražite mrežne blokove koje oglašava broj autonomnog sistema.

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

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

Pregledajte SSL/TLS sertifikat za hostname i port (podrazumevani port je 443).

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

Svi odgovori su JSON sa poljem status ("ok" ili "error"). Domen, IP ili ASN koji pretražujete nikada se ne čuva — čuvamo samo zbirni dnevni broj zahteva po nalogu. Pogledajte našu stranicu o privatnosti.

Token nije potreban

Ove dve krajnje tačke vraćaju vašu IP adresu kao običan tekst — bez naloga, bez tokena, bez parsiranja JSON-a.

GET /ip.txt

Vaša IP adresa, bez obzira na protokol kojim ste se povezali.

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

GET /ipv6.txt

Vaša IPv6 adresa, samo ako ste se tako povezali — u suprotnom prazan odgovor.

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

Postman kolekcija

Preuzmite Postman kolekciju za svaku krajnju tačku na ovoj stranici, spremnu za uvoz.

Javni API