Remplacement compatible d'ip-api.com

L'endpoint JSON d'ip-api est l'un des formats de recherche d'IP les plus copiés. ipapi.mygeocode.com renvoie les mêmes noms de champs pour les adresses IPv4 et IPv6, en HTTPS y compris sur les clés gratuites, ce qu'ip-api ne propose pas.

Changez un seul nom d'hôte

Hôte d'origine	`ip-api.com` `pro.ip-api.com`
À utiliser à la place	`ipapi.mygeocode.com`
Paramètre de clé	`key` (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 "http://ip-api.com/json/8.8.8.8?fields=status,country,countryCode,city,lat,lon,timezone,isp,query"

Après

curl "https://ipapi.mygeocode.com/json/8.8.8.8?fields=status,country,countryCode,city,lat,lon,timezone,isp,query"

Pourquoi changer

L'endpoint gratuit d'ip-api fonctionne uniquement en HTTP, pour un usage non commercial, et est limité à 45 requêtes par minute. Ici, c'est en HTTPS, l'usage commercial est autorisé, et toute adresse dispose de 2 500 par jour avant de payer quoi que ce soit, avec ou sans clé.

Le même quota gratuit, avec ou sans clé. Les requêtes vers ipapi.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 ipapi.mygeocode.com	Rôle	Fourni par
`/json/{ip}`	Recherche par adresse, IPv4 ou IPv6	Recherche IPv4
`/json/`	Rechercher l'appelant	Recherche IPv4
`/batch (POST, JSON array)`	Recherche par lots, jusqu'à 100	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 ip-api. Seules les données qu'ils contiennent sont les nôtres.

Réponse de ipapi.mygeocode.com

{
  "status": "success",
  "country": "United States",
  "countryCode": "US",
  "region": "CA",
  "regionName": "California",
  "city": "Mountain View",
  "zip": "94043",
  "lat": 37.4056,
  "lon": -122.0775,
  "timezone": "America/Los_Angeles",
  "isp": "Google LLC",
  "org": "Google Public DNS",
  "as": "AS15169 Google LLC",
  "query": "8.8.8.8"
}

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é ip-api.com : le paramètre de requête key. 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 ip-api.com et rien d'autre, de sorte qu'une réponse peut être intégrée à du code qui analyse déjà ip-api.com. 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.

La réponse par défaut est le jeu de champs propre à ip-api, dans son ordre. fields accepte des noms ou le masque de bits numérique, et lang traduit les noms de pays et de continents en de, es, pt-BR, fr, ja, zh-CN et ru.
Les formats json, xml, csv et line fonctionnent tous.
Une adresse invalide renvoie HTTP 200 avec status: fail, comme ip-api ; seuls les refus liés à la clé et au quota modifient le code de statut.
L'endpoint par lots accepte jusqu'à 100 entrées avec fields et lang par entrée, comme ip-api ; chaque adresse qu'il contient compte pour une requête.
Demandez reverse et le nom d'hôte est résolu pour cette adresse.
Les noms de région sont renvoyés sous forme de codes courts pour les États-Unis, le Canada et l'Australie ; ailleurs, le jeu de données ne contient que le nom complet.

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.