Remplacement compatible d'ipstack

Les endpoints standard lookup et check d'ipstack répondent sur ipstack.mygeocode.com avec les mêmes champs de premier niveau et le même objet location, en HTTPS sur toutes les offres.

Changez un seul nom d'hôte

Hôte d'origine	`api.ipstack.com`
À utiliser à la place	`ipstack.mygeocode.com`
Paramètre de clé	`access_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://api.ipstack.com/8.8.8.8?access_key=YOUR_IPSTACK_KEY"

Après

curl "https://ipstack.mygeocode.com/8.8.8.8?access_key=YOUR_MYGEOCODE_KEY"

Pourquoi changer

L'offre gratuite d'ipstack fonctionne uniquement en HTTP et est plafonnée à 100 par mois. Ici, chaque clé dispose de 2 500 par jour en HTTPS.

Le même quota gratuit, avec ou sans clé. Les requêtes vers ipstack.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 ipstack.mygeocode.com	Rôle	Fourni par
`/{ip}`	Recherche standard	Recherche IPv4
`/check`	Rechercher l'appelant	Recherche IPv4
`/{ip},{ip},{ip}`	Recherche en masse	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 ipstack. Seules les données qu'ils contiennent sont les nôtres.

Réponse de ipstack.mygeocode.com

{
  "ip": "8.8.8.8",
  "type": "ipv4",
  "continent_code": "NA",
  "continent_name": "North America",
  "country_code": "US",
  "country_name": "United States",
  "region_code": "CA",
  "region_name": "California",
  "city": "Mountain View",
  "zip": "94043",
  "latitude": 37.4056,
  "longitude": -122.0775,
  "location": {
    "geoname_id": 5375480,
    "capital": "Washington D.C.",
    "languages": [ { "code": "en", "name": "English", "native": "English" } ],
    "country_flag": "https://www.mygeocode.com/assets/img/flags/us.svg",
    "country_flag_emoji": "🇺🇸",
    "country_flag_emoji_unicode": "U+1F1FA U+1F1F8",
    "calling_code": "1",
    "is_eu": false
  }
}

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

Le bloc time_zone est renseigné : identifiant, heure locale actuelle, décalage, abréviation et application ou non de l'heure d'été.
Une clé manquante renvoie l'erreur 101 missing_access_key et une clé erronée 101 invalid_access_key.
region_code est un code court pour les États-Unis, le Canada et l'Australie ; ailleurs, le jeu de données ne contient que le nom complet.
Les recherches en masse acceptent jusqu'à 50 adresses séparées par des virgules, comme ipstack (au-delà, la réponse est 302 too_many_ips), et chaque adresse compte pour une requête, comme ipstack les compte.
Les champs qui nécessitent un jeu de données dont nous n'avons pas encore la licence (identifiant geoname, capitale, langues, indicatif téléphonique) sont présents et valent null.

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.