Publié le 04/12/2013
Auteur fobec
Réseaux sociaux
0 partages
0 tweets
2 plus
1 commentaires

Api IPv4 To Regional Internet registry

Les RIR (Regional Internet Registry) sont 5 organismes ayant pour but de maintenir une carte d'identité pour chaque adresse ip. Cette carte d'identité, appelée Whois, peut être consultée par tout le monde et fournit un minimum d'information sur l'utilisateur de l'adresse IP.

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>
L'erreur 400 est générée lorsque la clé ou l'adresse ip sont dans un format non reconnu par l'API.

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>
L'erreur 401 correspond à une erreur dans la clé d'identification. L'erreur 403 est générée lorsque le nombre de requêtes journalières autorisées est dépassé.

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.

Ajouter un commentaire

Les champs marqués d'un * sont obligatoires, les adresses emails se sont pas publiées.
avatar Fobec

Publié par Fobec

le 05/10/2014 à 10:40:39

L'api ip to RIR est compatible avec les adresses IP au format ipV6

A lire aussi

Réseaux sociaux
Présentation de l'article
Catégorie
logiciel - online
Mise a jour
04/12/2013
Visualisation
vu 3582 fois
Public
Internaute
Auteur de la publication
Fobec
Admin
Auteur de 261 articles
|BIO_PSEUDO|
Commentaires récents

Publié par D&Atilde;&copy;butant dans CMS

merci , et bon courage pour d'autre programme

Publié par traitstone dans CMS

c'est bou et tres bon chose

Publié par farid dans CMS

formation delphi 7

Publié par hisy dans java

Merci pour le script mais si un champ text contient un ";" ...

Publié par Bonjour dans java

Joli travail!
Par contre, savez vous que votre barre de progression s'arrête à un certain pourcentage?