Voir la source de IPinfo

Si vous désirez n'utiliser que 50 000 requetes par mois, c'est idéal!

On s'inscrit en donnant une simple adresse mail et on récupère un token.<syntaxhighlight lang="bash">
export IPINFO_TOKEN="546425b91c438b"  # c'est un exemple
</syntaxhighlight>La requête la plus simple :<syntaxhighlight lang="bash">
curl "ipinfo.io/95.142.161.196?token=$IPINFO_TOKEN"
</syntaxhighlight>Donne la localisation de l'IP du serveur hébergeant ce wiki.<syntaxhighlight lang="json-object">
{
  "ip": "95.142.161.196",
  "hostname": "xvm-161-196.dc0.ghst.net",
  "city": "Paris",
  "region": "Île-de-France",
  "country": "FR",
  "loc": "48.8534,2.3488",
  "org": "AS203476 GANDI SAS",
  "postal": "75000",
  "timezone": "Europe/Paris"
}
</syntaxhighlight>Hé oui je suis hébergé chez Gandi depuis plus de 10 ans et j'en suis très satisfait!

== Authentification ==
Nous avons vu ci-dessus une méthode pour utiliser le token. En fait il y en a trois <syntaxhighlight lang="bash">
# Avec Basic Auth user sans password
$ curl -u $IPINFO_TOKEN: ipinfo.io/95.142.161.196

# Avec Bearer token
$ curl -H "Authorization: Bearer $IPINFO_TOKEN" ipinfo.io/95.142.161.196

# Dans la query
$ curl ipinfo.io/95.142.161.196?token=$IPINFO_TOKEN
</syntaxhighlight>Les 3 nous donnent le même "json" en réponse.

== Protocoles ==
Dans le cas ci dessus on ne précise pas le protocole. Par défaut c'est le http qui est utilisé par curl mais o peut également utiliser https.<syntaxhighlight lang="bash">
#HTTP
curl -u $IPINFO_TOKEN: http://ipinfo.io/95.142.161.196
#HTTPS
curl -u $IPINFO_TOKEN: http://ipinfo.io/95.142.161.196
</syntaxhighlight>

== Les options ==

=== IPV4 ou IPV6 ===
IPInfo sait indifféremment traiter des IP V4 ou V6.<syntaxhighlight lang="bash">
#IP V4
curl -u $IPINFO_TOKEN: http://ipinfo.io/95.142.161.196
#IP V6
curl -u $IPINFO_TOKEN: http://ipinfo.io/2001:4b98:dc0:47:216:3eff:feaa:4fe7
</syntaxhighlight>C'est toujours le même serveur donc, la même réponse.

=== Adresse par defaut ===
Si on ne précise pas une IP c'est l'adresse IP du client telle qu'elle est vue par le serveur qui est utilisée.<syntaxhighlight lang="bash">
curl -u $IPINFO_TOKEN: http://ipinfo.io/95.142.161.196
curl -u $IPINFO_TOKEN: http://ipinfo.io/
</syntaxhighlight>Donnent le même résultat si le client est 95.142.161.196

=== Filtrage de la réponse ===
On peut ne demander que certaines informations.

Si la requête globale :<syntaxhighlight lang="bash">
curl -u $IPINFO_TOKEN: http://ipinfo.io/95.142.161.196
# Equivalant a la demande explicite 
curl -u $IPINFO_TOKEN: http://ipinfo.io/95.142.161.196/json
</syntaxhighlight>Réponds:<syntaxhighlight lang="json-object">
{
  "ip": "95.142.161.196",
  "hostname": "xvm-161-196.dc0.ghst.net",
  "city": "Paris",
  "region": "Île-de-France",
  "country": "FR",
  "loc": "48.8534,2.3488",
  "org": "AS203476 GANDI SAS",
  "postal": "75000",
  "timezone": "Europe/Paris"
}
</syntaxhighlight>On peut ne demander que l'un des champs ci-dessus:<syntaxhighlight lang="bash">
curl -u $IPINFO_TOKEN: http://ipinfo.io/95.142.161.196/country
</syntaxhighlight>Nous réponds simplement:<syntaxhighlight lang="text">
FR
</syntaxhighlight>et<syntaxhighlight lang="bash">
curl -u $IPINFO_TOKEN: http://ipinfo.io/95.142.161.196/timezone
</syntaxhighlight>un simple :<syntaxhighlight lang="text">
Europe/Paris
</syntaxhighlight>

== Le "content-type" ==
IPInfo nous donne un content type qui correspond à notre demande.<syntaxhighlight lang="bash">
curl -i -u $IPINFO_TOKEN: http://ipinfo.io/95.142.161.196/
curl -i -u $IPINFO_TOKEN: http://ipinfo.io/95.142.161.196/json
</syntaxhighlight>Les deux commandes nous renvoient un objet JSON et donc un content-type:<syntaxhighlight lang="http">
HTTP/1.1 200 OK
content-type: application/json; charset=utf-8
</syntaxhighlight>En revanche si on demande un champ spécifique.<syntaxhighlight lang="bash">
curl -i -u $IPINFO_TOKEN: http://ipinfo.io/95.142.161.196/country
</syntaxhighlight>Réponds par :<syntaxhighlight lang="http">
HTTP/1.1 200 OK
content-type: text/html; charset=utf-8
</syntaxhighlight>Ce qui est étrange on s'attendrais à avoir un <code>text/plain</code> mais non.

De la même façon on peut lui demander un format spécifique avec, par exemple, une option curl  <code>-H "Accept: application/json"</code> sur une requête <code>/country</code> rien n'y fait le serveur IPInfo impose son format.

== Requêtes en IPV6 ==
Tous les exemples ci dessus ont été fait en IPV4 (même quand on demande le détail d'une adresse IPV6 la requête était faite en IPV4)

[[Fichier:Curl IPV4.png|sans_cadre|1310x1310px]]

est le résultat dans Wireshark de la requête:<syntaxhighlight lang="bash">
curl -u $IPINFO_TOKEN: http://ipinfo.io/2001:4b98:dc0:47:216:3eff:feaa:4fe7
</syntaxhighlight>On voit le GET /2001:4b98:dc0:47:216:3eff:feaa:4fe7 qui est bien la requête du détail d'une adresse IPV6 au travers de trames IPV4.

Pour faire une requête en IPV6 j'au dû passer sur une "vrai" machine linux. Le wsl de windows ne sait pas faire d'IPV6 (derrière un NAT V4 interne à windows)

On tente donc un :<syntaxhighlight lang="bash">
curl -u $IPINFO_TOKEN: http://v6.ipinfo.io/2001:4b98:dc0:47:216:3eff:feaa:4fe7
</syntaxhighlight>Et on utilise tcpdump à la place de wireshark (mon serveur linux fait seulement de la ligne de commande).<syntaxhighlight lang="text">
00:31:08.884049 IP6 xvm6-dc0-feaa-4fe7.ghst.net.34548 > 2600:1901:0:13e0::.http: Flags [S], seq 2678455541, win 64800, options [mss 1440,sackOK,TS val 3419243256 ecr 0,nop,wscale 7], length 0
00:31:08.884775 IP6 2600:1901:0:13e0::.http > xvm6-dc0-feaa-4fe7.ghst.net.34548: Flags [S.], seq 549389614, ack 2678455542, win 65535, options [mss 1440,sackOK,TS val 1351958675 ecr 3419243256,nop,wscale 8], length 0
00:31:08.884804 IP6 xvm6-dc0-feaa-4fe7.ghst.net.34548 > 2600:1901:0:13e0::.http: Flags [.], ack 1, win 507, options [nop,nop,TS val 3419243257 ecr 1351958675], length 0
00:31:08.884957 IP6 xvm6-dc0-feaa-4fe7.ghst.net.34548 > 2600:1901:0:13e0::.http: Flags [P.], seq 1:134, ack 1, win 507, options [nop,nop,TS val 3419243257 ecr 1351958675], length 133: HTTP: GET /95.142.161.196 HTTP/1.1
00:31:08.885610 IP6 2600:1901:0:13e0::.http > xvm6-dc0-feaa-4fe7.ghst.net.34548: Flags [.], ack 134, win 1054, options [nop,nop,TS val 1351958676 ecr 3419243257], length 0
00:31:08.987450 IP6 2600:1901:0:13e0::.http > xvm6-dc0-feaa-4fe7.ghst.net.34548: Flags [P.], seq 1:629, ack 134, win 1054, options [nop,nop,TS val 1351958778 ecr 3419243257], length 628: HTTP: HTTP/1.1 200 OK
00:31:08.987501 IP6 xvm6-dc0-feaa-4fe7.ghst.net.34548 > 2600:1901:0:13e0::.http: Flags [.], ack 629, win 503, options [nop,nop,TS val 3419243360 ecr 1351958778], length 0
00:31:08.988075 IP6 xvm6-dc0-feaa-4fe7.ghst.net.34548 > 2600:1901:0:13e0::.http: Flags [F.], seq 134, ack 629, win 503, options [nop,nop,TS val 3419243360 ecr 1351958778], length 0
00:31:08.988789 IP6 2600:1901:0:13e0::.http > xvm6-dc0-feaa-4fe7.ghst.net.34548: Flags [F.], seq 629, ack 135, win 1054, options [nop,nop,TS val 1351958779 ecr 3419243360], length 0
00:31:08.988818 IP6 xvm6-dc0-feaa-4fe7.ghst.net.34548 > 2600:1901:0:13e0::.http: Flags [.], ack 630, win 503, options [nop,nop,TS val 3419243361 ecr 1351958779], length 0

</syntaxhighlight>

== Conclusion ==
On a bien des requêtes IPV6 : <code>IP6 xvm6-dc0-feaa-4fe7.ghst.net.50978 > 2600:1901:0:13e0::.http</code> qui transportent un <code>GET /95.142.161.196</code> pour avoir les infos d'une adresse IPV4.

Donc la base de donnée interrogée contient les adresses IP V4 comme les adresses IPV6 et le protocole de requête peut être du <code>http</code> et du <code>https</code>  sur des trames '''IPV4''' ou '''IPV6''' de façon indifférenciée.

Cette API est très simple, limitée à 50 000 req/mois sans avoir a commencer a payer.