Remplacement compatible d'ipinfo.io

Le JSON compact d'ipinfo, avec une chaîne loc et une chaîne org précédée du numéro d'AS, est reproduit sur ipinfo.mygeocode.com. Les bibliothèques clientes officielles d'ipinfo acceptent une URL de base personnalisée, elles fonctionnent donc aussi.

Changez un seul nom d'hôte

Hôte d'origine	`ipinfo.io`
À utiliser à la place	`ipinfo.mygeocode.com`
Paramètre de clé	`token` (facultatif : toute adresse dispose de 2 500 requêtes par jour sans clé ; mettez ici votre clé My Geocode pour le crédit, les forfaits et un historique d'utilisation)

Avant

curl "https://ipinfo.io/8.8.8.8/json?token=YOUR_IPINFO_TOKEN"

Après

curl "https://ipinfo.mygeocode.com/8.8.8.8/json?token=YOUR_MYGEOCODE_KEY"

Pourquoi changer

L'offre gratuite d'ipinfo est de 50 000 par mois, sans détails de géolocalisation sur certains champs. Ici, chaque clé dispose de 2 500 par jour avec tous les champs, et l'usage payant est facturé à la requête ou au forfait.

Le même quota gratuit, avec ou sans clé. Les requêtes vers ipinfo.mygeocode.com sont décomptées des mêmes 2 500 requêtes gratuites par jour dont votre adresse, ou votre clé, dispose sur nos propres endpoints. Au-delà, crédit prépayé à 0,0001 € par requête, ou 50 € par mois pour une clé Unlimited. L'inscription ne demande qu'une adresse e-mail, rien d'autre.

Voir les tarifs Obtenir une clé gratuite

Endpoints

Chemin sur ipinfo.mygeocode.com	Rôle	Fourni par
`/{ip}/json`	Recherche par adresse	Recherche IPv4
`/{ip}`	Recherche par adresse (même réponse)	Recherche IPv4
`/json`	Rechercher l'appelant	Recherche IPv4
`/{ip}/{field}`	Champ unique, en texte brut (city, country, loc, org, timezone)	Recherche IPv4

Exemple de réponse

Voici ce que renvoie la requête ci-dessus. Les noms de champs, l'imbrication et les types suivent ipinfo. Seules les données qu'ils contiennent sont les nôtres.

Réponse de ipinfo.mygeocode.com

{
  "ip": "8.8.8.8",
  "hostname": "dns.google",
  "city": "Mountain View",
  "region": "California",
  "country": "US",
  "loc": "37.4056,-122.0775",
  "org": "AS15169 Google LLC",
  "postal": "94043",
  "timezone": "America/Los_Angeles"
}

Détails et différences

Aucune clé n'est nécessaire pour les 2 500 premières requêtes de la journée. Pour utiliser une clé My Geocode, placez-la là où se trouvait votre clé ipinfo.io : le paramètre de requête token, un jeton Bearer, ou curl -u YOUR_KEY: comme dans les exemples d'ipinfo. L'en-tête X-API-Key, Authorization: Bearer et l'authentification HTTP Basic (la clé comme nom d'utilisateur) fonctionnent aussi sur tous les hôtes, de sorte que les bibliothèques clientes qui s'authentifient à leur manière continuent de fonctionner sans modification.

Les réponses contiennent les champs que renvoie ipinfo.io et rien d'autre, de sorte qu'une réponse peut être intégrée à du code qui analyse déjà ipinfo.io. Nos données supplémentaires (altitude du sol, menaces et détails du réseau) sont disponibles sur demande : ajoutez mg_extras=1 à la requête ou envoyez X-MG-Extras: 1.

hostname provient d'une résolution DNS inverse et est omis lorsque l'adresse n'a pas d'enregistrement PTR, exactement comme chez ipinfo.
anycast apparaît lorsque l'adresse est anycast, et les plages réservées renvoient bogon.
Une adresse invalide renvoie 404 avec le corps « Wrong ip » d'ipinfo.
Le champ readme n'apparaît jamais, car chaque requête est ici authentifiée.
Les endpoints à champ unique (/8.8.8.8/city et similaires) renvoient du texte brut.
POST /batch fonctionne comme chez ipinfo : un tableau JSON de 1 000 adresses au maximum, chemins address/field ou URL complètes, renvoie un objet dont les clés sont les entrées, filter=1 supprime les entrées vides, et chaque entrée compte pour une recherche, comme ipinfo les compte. Un lot plus grand que ce qui reste du quota de la journée est refusé en entier avec le 429 d'ipinfo plutôt que partiellement traité.

Si votre client dépend d'un champ ou d'un comportement qui ne figure pas ici, dites-le-nous. Les écarts de compatibilité sont corrigés rapidement, car ils sont généralement minimes.

Autres hôtes compatibles

Fonctionnement des hôtes compatibles, la vue d'ensemble et les remplacements compatibles pour bibliothèques JavaScript.