API-Dokumentation

Authentifizierung

Jede Anfrage muss Ihren Token als Bearer-Token enthalten:

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

Anfragen ohne gültigen Token erhalten 401. Anfragen von einem deaktivierten Konto erhalten 403, ebenso Anfragen von einer IP-Adresse außerhalb der erlaubten IP-Liste Ihres Kontos (falls Sie eine festgelegt haben — verwalten Sie sie auf Ihrer Kontoseite). Jedes Konto hat sein eigenes Limit pro Minute; bei Überschreitung wird 429 mit Retry-After und dem Antwort-Header-Paar X-RateLimit-Limit / X-RateLimit-Remaining zurückgegeben.

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

Einen einzelnen DNS-Eintragstyp für eine Domain abfragen.

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

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

Land, Stadt, ISP und ASN für eine IPv4- oder IPv6-Adresse abfragen. Private, Loopback- und andere nicht öffentliche Adressen werden nicht nachgeschlagen: Stattdessen enthält die Antwort ein special-Objekt, das die Adresse beschreibt.

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

POST /api/public/v1/ip

Bis zu 30 IP-Adressen in einer Anfrage abfragen. Senden Sie einen JSON-Body mit einem ips-Array. Die Ergebnisse kommen in Eingabereihenfolge zurück, Duplikate werden entfernt; eine ungültige Adresse lässt nur ihre eigene Zeile fehlschlagen ("status": "error"). Mehr als 30 Adressen liefern 422. Private, Loopback- und andere nicht öffentliche Adressen kommen statt Standortdaten mit einem special-Objekt zurück.

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}

Die von einer Autonomous System Number angekündigten Netzblöcke abfragen.

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

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

SSL/TLS-Zertifikat für einen hostname und Port prüfen (Port standardmäßig 443).

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

Alle Antworten sind JSON mit einem Feld status ("ok" oder "error"). Die abgefragte Domain, IP oder ASN wird nie gespeichert — wir führen nur eine aggregierte tägliche Anfragezählung pro Konto. Siehe unsere Datenschutzseite.

Kein Token erforderlich

Diese beiden Endpunkte liefern Ihre eigene IP-Adresse als reinen Text — kein Konto, kein Token, kein JSON-Parsing nötig.

GET /ip.txt

Ihre IP-Adresse, egal mit welchem Protokoll Sie verbunden sind.

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

GET /ipv6.txt

Ihre IPv6-Adresse, nur wenn Sie so verbunden sind — sonst eine leere Antwort.

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

Postman-Collection

Laden Sie die Postman-Collection herunter — für jeden Endpunkt auf dieser Seite, bereit zum Import.

Public API