L'API ipToRir fournit pour chacune des 4 294 967 296 adresses IPv4, le serveur Whois en charge de maintenir la carte d'identité. Les données sont régulièrement maintenus à jour et sont plus précises que la répartition fournie par l'IANA.
Lors de vos requêtes Whois, vous obtenez des réponses de type http://www.iana.org, Transferred to RIPE NCC ou encore is not administered by APNIC, le RIR intérrogé n'est pas le bon, l'API est faites pour vous !
Comment utiliser l'API ip to RIR
L'api fonctionne à partir d'une requête de type GET classique, accessible à partir de n'importe quel langage de programmation. L'URL comporte 2 paramètres obligatoire:key: la clé d'authentification
ip: l'adresse ip au format V4
en option
format: par défaut les données sont présentées en XML. La valeur format=json utilise le format Json.
Exemple pour l'adresse 8.8.8.8
<?xml version="1.0" encoding="UTF-8" ?>
<iptorir>
<status>200</status>
<ip>8.8.8.8</ip>
<range>8.0.0.0 - 8.255.255.255</range>
<haswhois>1</haswhois>
<registry>ARIN</registry>
<whois>whois.arin.net</whois>
<update>04/12/2013</update>
</iptorir>
A quoi correspondent ces valeurs ?
status: la valeur 200 signifie que tout s'est bien passé,
ip: l'adresse ip pour laquelle les données sont affichées,
range: plage d'adresse affectée au RIR, c-a-d les ip de 8.0.0.0 à 8.255.255.255 sont maintenues par l'ARIN,
haswhois: la valeur 1 signifie qu'un Whois est disponible,
registry: nom du RIR, à savoir ARIN, APNIC, RIPE, AFRINIC, LACNIC ou alors l'IANA dans certains cas de figure,
whois: adresse du serveur whois à interroger,
update: date de la mise à jour des données.
Exemple pour l'adresse 127.0.0.1
<?xml version="1.0" encoding="UTF-8" ?>
<iptorir>
<status>200</status>
<ip>127.0.0.1</ip>
<range>127.0.0.0 - 127.255.255.255</range>
<haswhois>0</haswhois>
<registry>RD</registry>
<whois>whois.iana.org</whois>
<update>04/12/2013</update>
</iptorir>
Qu'est ce qui change ?
haswhois: la valeur 0 indique qu'il n'existe pas de Whois pour cette adresse,
registry: les ip réservées sont marquées RD
Gestion des erreurs
Afin de faciliter la mise en place et le contrôle dans vos applications, l'API intègre une gestion des erreurs. Le code de l'erreur est retourné dans la propriété status et le libellé de l'erreur est contenu dans la propriété message. Pour résumer, le numéro des erreurs correspond à la classification des codes HTTP.Erreur 400: format de la requete
<?xml version="1.0" encoding="UTF-8" ?>
<iptorir>
<status>400</status>
<message>Bad Request</message>
</iptorir>
Erreur 401: requête non autorisée, Erreur 403: Forbidden
<?xml version="1.0" encoding="UTF-8" ?>
<iptorir>
<status>401</status>
<message>Unauthorized</message>
</iptorir>
Obtenir une clé et Feedback
Recevoir un cléEn attendant une procédure automatique, la demande de clé d'authentification devra être faite par email (info@nomdedomainedusite) ou au travers du forum.
Indiquez dans votre message une adresse email qui servira à générer la clé et à etre informer des mises à jour.
Etat du projet
L'exploration des plages d'IP est quasiment achevée. La base RIR comporte un peu plus de 2000 ranges distincts. .
Usage et limite de l'API
Aucun garantie n'est fournie pour les données, les valeurs retournée sont retournées à titre indicatif.
L'API est gratuite pour un usage privé et limité à 500 requêtes par jour. Aucune reproduction n'est permise quelque soit le support.
Aide et évolution
Un billet est ouvert dans le forum consacré au support de l'api.
