API
Les mêmes données que le site, en JSON ou en texte brut. Sans clé ni compte ; des limites d’usage raisonnables s’appliquent.
curl https://ipaddress.tr/api/v1/my-ip?format=textPoints d’accès
| Chemin | Description | Données | Limites de débit |
|---|---|---|---|
| GET/api/v1/my-ipEssayer: /api/v1/my-ip | Votre adresse IP (aussi en texte brut avec ?format=text). | Jeux de données propres | 120 · 240/min |
| GET/api/v1/ip/{address}Essayer: /api/v1/ip/144.122.145.153 | Données de réseau, de routage, de registre et de localisation pour une adresse. | Jeux de données propres | 30 · 30/min |
| GET/api/v1/ip/geolocation?ip=Essayer: /api/v1/ip/geolocation?ip=177.224.0.1 | Seulement la localisation estimée d’une adresse (DB-IP Lite), toujours signalée comme estimation. | Jeux de données propres | 30 · 30/min |
| GET/api/v1/ip/asn?ip=Essayer: /api/v1/ip/asn?ip=2001:1208::1 | L’AS d’origine et le préfixe annoncé d’une adresse, et la délégation du registre qui la contient. | Jeux de données propres | 30 · 30/min |
| GET/api/v1/ip/reverse?ip=Essayer: /api/v1/ip/reverse?ip=8.8.8.8 | L’enregistrement PTR d’une adresse publique, en direct, avec confirmation directe. | Requête en direct | 40 · 60/min |
| GET/api/v1/ip/blacklist?ip=Essayer: /api/v1/ip/blacklist?ip=8.8.8.8 | Résultats DNSBL en direct (SpamCop, PSBL, DroneBL, s5h.net) et l’indicateur de sortie Tor d’une adresse publique. | Requête en direct | 40 · 60/min |
POST/api/v1/bulkcurl --data-binary $'1.1.1.1\n9.9.9.9' https://ipaddress.tr/api/v1/bulk | Jusqu’à 100 adresses à la fois (JSON {"addresses": […]} ou une par ligne), traitées uniquement à partir de nos propres données. Rien n’est conservé. | Jeux de données propres | 6 · 3/min |
| GET/api/v1/asn/{asn}Essayer: /api/v1/asn/AS8151 | Titulaire, registre et préfixes annoncés d’un système autonome. | Jeux de données propres | 30 · 30/min |
| GET/api/v1/network/{cidr}Essayer: /api/v1/network/144.122.0.0/16 | Un réseau en notation CIDR : taille, plage, usage spécial, qui l’annonce (avec RPKI), la délégation du registre et une estimation de localisation. | Jeux de données propres | 30 · 30/min |
| GET/api/v1/network/ipv4?cidr=Essayer: /api/v1/network/ipv4?cidr=192.168.1.37/24 | Calcul de sous-réseau pour un réseau IPv4 ou IPv6 : réseau, broadcast, masques, plage utilisable et totaux. | Jeux de données propres | 120 · 240/min |
| GET/api/v1/network/ipv6?cidr=Essayer: /api/v1/network/ipv6?cidr=2001:db8::/48 | Calcul de sous-réseau pour un réseau IPv4 ou IPv6 : réseau, broadcast, masques, plage utilisable et totaux. | Jeux de données propres | 120 · 240/min |
| GET/api/v1/country/{cc}Essayer: /api/v1/country/MX | Espace d'adressage et numéros d'AS enregistrés d'un pays, ce que ses réseaux annoncent, la couverture RPKI et les principaux réseaux (pour TR, aussi l'estimation par province). | Jeux de données propres | 30 · 30/min |
| GET/api/v1/dns/{domain}?type=A,MXEssayer: /api/v1/dns/metu.edu.tr?type=A,MX | Enregistrements DNS actuels d’un domaine. | Requête en direct | 40 · 60/min |
| GET/api/v1/dns/propagation?name=&type=Essayer: /api/v1/dns/propagation?name=metu.edu.tr&type=A | La même question DNS posée à plusieurs résolveurs publics, avec chaque réponse et leur concordance. | Requête en direct | 40 · 60/min |
| GET/api/v1/rdap/{query}Essayer: /api/v1/rdap/AS8151 | Données d’enregistrement du serveur RDAP responsable. | Requête en direct | 10 · 6/min |
| GET/api/v1/healthEssayer: /api/v1/health | Disponibilité du service. | Jeux de données propres | 120 · 240/min |
| GET/api/v1/data-statusEssayer: /api/v1/data-status | Âge et taille de chaque jeu de données. | Jeux de données propres | 120 · 240/min |
Raccourcis en texte brut hors de /api/v1 : /raw renvoie votre adresse, /json le même objet que /my-ip et /country le code pays estimé.
Chaque endpoint à chemin existe aussi avec des paramètres : /ip/lookup?ip=, /asn/lookup?asn=, /dns/lookup?name=, /network/cidr?cidr=. Chaque réponse porte un en-tête X-Request-Id.
curl ipaddress.tr/rawcurl ipaddress.tr/jsoncurl ipaddress.tr/countryLimites de débit
Les requêtes sont limitées par adresse client avec un seau à jetons. À la limite, l’API répond 429 avec un en-tête Retry-After. Le décompte se fait en mémoire avec une clé hachée renouvelée chaque jour ; les adresses ne sont pas conservées.
Erreurs
Les erreurs utilisent les codes de statut HTTP et un corps JSON de la forme {"error": {"code": "…", "message": "…"}}.
Versions
Les chemins sous /api/v1/ conservent leur structure de réponse. De nouveaux champs peuvent s’ajouter ; les champs existants ne sont ni supprimés ni renommés dans la v1.
Attribution
Les données de localisation proviennent de DB-IP (CC BY 4.0). Si vous les affichez, créditez DB-IP comme l’exige la licence.