ip-api.com est souvent le premier service de géolocalisation IP vers lequel se tourne un développeur, surtout parce qu'il est rapide à essayer et facile à intégrer dans un script. C'est précisément cette simplicité que notre hôte compatible est conçu pour préserver, tout en s'appuyant sur d'autres règles de quotas et de tarifs.
L'hôte reproduit à l'identique le traitement des requêtes et le corps de réponse d'ip-api.com, à l'exception des textes de copyright, de conditions et de confidentialité, qui sont les nôtres. Une requête qui visait l'endpoint d'ip-api.com peut viser le nôtre à la place, et le JSON renvoyé s'analyse de la même façon, avec les mêmes noms de champs aux mêmes endroits.
Comme /v1/ip résout entièrement les deux familles d'adresses, cet hôte compatible traite les recherches IPv4 et IPv6 de la même manière. Une recherche sur une adresse IPv4 comme sur une adresse IPv6 revient avec la bonne structure, sans qu'aucune option supplémentaire ne soit nécessaire pour indiquer à l'hôte quel type d'adresse il traite.
Les clés s'authentifient ici de la même façon que partout ailleurs sur My Geocode : 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. La méthode qu'utilise déjà votre intégration actuelle est acceptée sans modification.
Les tarifs de cet hôte sont les mêmes que ceux de tous nos autres hôtes et endpoints. Toute adresse bénéficie de 2 500 recherches IP gratuites par jour sans aucune clé, comptées par réseau. Une clé ajoute ses propres 2 500 requêtes gratuites par jour, séparément. Au-delà, le crédit prépayé coûte 0,0001 € la requête, ou un forfait Unlimited couvre tout pour 50 € par mois, sans supplément pour l'utilisation d'un hôte compatible plutôt que de /v1/ip directement.
Les en-têtes de quota accompagnent ici aussi chaque réponse, ce qu'une intégration ip-api.com classique ne fournit généralement pas d'elle-même : X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Quota-Network-Used, X-Credits-Remaining, X-Key-IPs-Used, X-Key-IPs-Limit et X-Quota-Reset sont tous inclus.
Pour les projets qui veulent plus qu'une recherche standard, ajouter mg_extras=1 à la requête, ou envoyer un en-tête X-MG-Extras, ajoute à la réponse compatible des champs facultatifs comme les informations sur les menaces et le réseau de l'IP, sans modifier sa structure de base sauf si vous le demandez.
Tous les détails se trouvent sur /compatibility/ip-api/. Si un script de votre stack communique déjà avec ip-api.com, le rediriger ici est un moyen rapide de mesurer la différence qu'apporte un hôte qui expose ses quotas et facture en euros.