Documentation de l'API

Authentification

Chaque requête doit inclure votre jeton en tant que jeton Bearer :

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

Les requêtes sans jeton valide reçoivent 401. Celles d'un compte désactivé reçoivent 403, tout comme celles d'une adresse IP absente de la liste d'adresses IP autorisées de votre compte (si vous en avez défini une — gérez-la depuis la page de votre compte). Chaque compte a sa propre limite par minute ; la dépasser renvoie 429 avec un en-tête Retry-After et la paire d'en-têtes de réponse X-RateLimit-Limit / X-RateLimit-Remaining.

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

Interrogez un seul type d'enregistrement DNS pour un domaine.

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

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

Obtenez le pays, la ville, l'ISP et l'ASN d'une adresse IPv4 ou IPv6. Les adresses privées, de bouclage et autres adresses non publiques ne sont pas recherchées : la réponse contient à la place un objet special qui décrit l'adresse.

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

POST /api/public/v1/ip

Recherchez jusqu'à 30 adresses IP en une seule requête. Envoyez un corps JSON avec un tableau ips. Les résultats reviennent dans l'ordre d'entrée, doublons supprimés ; une adresse invalide ne fait échouer que sa propre ligne ("status": "error"). Plus de 30 adresses renvoient 422. Les adresses privées, de bouclage et autres adresses non publiques reviennent avec un objet special au lieu de données de localisation.

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}

Recherchez les blocs réseau annoncés par un numéro de système autonome.

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

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

Inspectez le certificat SSL/TLS d'un hostname et d'un port (le port par défaut est 443).

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

Toutes les réponses sont du JSON avec un champ status ("ok" ou "error"). Le domaine, l'IP ou l'ASN que vous interrogez n'est jamais stocké — nous ne conservons qu'un décompte quotidien agrégé des requêtes par compte. Consultez notre page de confidentialité.

Aucun jeton requis

Ces deux points d'accès renvoient votre propre adresse IP en texte brut — sans compte, sans jeton, sans analyse JSON.

GET /ip.txt

Votre adresse IP, quel que soit le protocole utilisé pour vous connecter.

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

GET /ipv6.txt

Votre adresse IPv6, uniquement si vous vous êtes connecté ainsi — sinon une réponse vide.

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

Collection Postman

Téléchargez la collection Postman pour chaque point d'accès de cette page, prête à importer.

API publique