ipinfo.io est un choix courant pour les équipes qui ont simplement besoin de répondre vite à une question : où se trouve cette adresse IP, et à quel réseau appartient-elle. Comme l'intégration est généralement petite, une seule fonction qui encapsule un appel HTTP, elle reste souvent intacte pendant des années, même quand l'équipe est par ailleurs prête à comparer les offres. Notre hôte compatible rend cette petite intégration facile à rediriger.
Dirigez vers notre hôte une requête qui partait vers ipinfo.io, et la réponse revient avec la même structure, champ pour champ, à l'exception des textes de copyright, de conditions et de confidentialité, qui sont les nôtres. Si votre code lit dans un corps JSON le pays, la région, la ville, les coordonnées ou les informations d'organisation, il continue de lire les mêmes champs aux mêmes endroits.
Puisque /v1/ip résout entièrement les adresses IPv4 comme IPv6, l'hôte compatible le fait aussi. Une recherche sur une adresse comme 8.8.8.8 renvoie immédiatement les champs de localisation et de réseau dans la structure attendue, sans configuration distincte pour l'une ou l'autre famille d'adresses.
L'authentification fonctionne comme sur tous les hôtes My Geocode : un en-tête X-API-Key, un en-tête Authorization: Bearer, l'authentification HTTP Basic avec la clé comme nom d'utilisateur, ou un paramètre de requête. Utilisez celle qu'envoie déjà votre intégration ipinfo.io existante, puisque les quatre sont acceptées ici aussi.
La structure tarifaire sous-jacente est la nôtre, et elle est cohérente partout sur la plateforme. Toute adresse bénéficie de 2 500 recherches gratuites par jour sans aucune clé, comptées par réseau afin qu'une connexion partagée ne soit pas répartie sur plusieurs clés pour multiplier ce quota. Une clé ajoute ses propres 2 500 requêtes gratuites par jour. Au-delà, le crédit prépayé coûte 0,0001 € la requête, ou un forfait Unlimited couvre l'utilisation pour 50 € par mois, sans tarif distinct pour cet hôte par rapport à un autre.
Chaque réponse comporte nos en-têtes de quota, ce qui offre sur l'utilisation quotidienne une visibilité qu'une intégration ipinfo.io classique ne fournirait pas autrement : X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Quota-Network-Used et X-Credits-Remaining sont présents à chaque appel.
Si vous voulez plus que la réponse IP standard, ajouter mg_extras=1 à la requête ou un en-tête X-MG-Extras ajoute à la structure compatible des extras facultatifs comme les informations sur les menaces et le réseau de l'IP, uniquement si vous le choisissez. Sans cette option, la réponse correspond exactement au format d'ipinfo.io.
L'hôte est documenté sur /compatibility/ipinfo/, et le fonctionnement de la recherche IP sous-jacente est décrit en détail sur /docs/ipv4-lookup/ et /docs/ipv6-lookup/.