De nombreuses applications ne font appel à la géolocalisation IP qu'une seule fois, au moment où un utilisateur se connecte pour la première fois, pour deviner un pays ou définir une devise par défaut, puis passent à autre chose. ipstack est depuis longtemps un choix courant pour cette étape unique. Notre nouvel hôte compatible permet à cette étape de continuer à fonctionner de la même façon, avec un autre backend.
L'hôte reproduit précisément les paramètres de requête et le corps de réponse d'ipstack, à l'exception des textes de copyright, de conditions et de confidentialité, qui concernent My Geocode et non le fournisseur d'origine. Partout où votre application envoie actuellement une recherche au format ipstack, elle peut envoyer cette même recherche à notre hôte, et les champs renvoyés arrivent aux endroits qu'attend votre code d'analyse existant.
Les deux familles d'adresses sont entièrement prises en charge ici, comme /v1/ip partout ailleurs sur la plateforme. Une adresse IPv4 et une adresse IPv6 sont toutes deux correctement résolues par cet hôte, avec la même structure de réponse dans les deux cas.
Les clés peuvent être transmises en en-tête X-API-Key, en en-tête Authorization: Bearer, en authentification HTTP Basic avec la clé comme nom d'utilisateur, ou en paramètre de requête, selon la méthode qu'utilise déjà votre intégration ipstack existante. Les quatre sont acceptées de façon identique sur tous nos hôtes et endpoints, si bien que le code d'authentification a rarement besoin de changer.
Les tarifs de cet hôte sont les mêmes que partout ailleurs. Toute adresse bénéficie de 2 500 recherches gratuites par jour sans clé, comptées par réseau afin qu'un bureau ou un bâtiment partagé puise dans une seule réserve plutôt que dans plusieurs. Une clé ajoute à elle seule 2 500 requêtes gratuites par jour supplémentaires. Au-delà de ces quotas, 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 compatible.
Chaque réponse comporte aussi l'ensemble de nos en-têtes de quota, ce qu'une intégration ipstack classique n'exposerait pas autrement : X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Quota-Network-Used et X-Credits-Remaining sont tous présents, appel après appel.
Si votre projet veut plus que la réponse standard, mg_extras=1 dans la requête, ou un en-tête X-MG-Extras, ajoute à la structure compatible des champs facultatifs comme les informations sur les menaces et le réseau de l'IP. L'option est désactivée par défaut, donc rien ne change dans le format de réponse tant que vous ne le demandez pas expressément.
L'hôte compatible est documenté sur /compatibility/ipstack/, et la référence complète de la recherche IP sur /docs/ipv4-lookup/ et /docs/ipv6-lookup/ couvre tout ce qui se trouve derrière.