My Geocode

Migration

Migrer depuis ipinfo.io

· 2 min de lecture · My Geocode · #ipinfo#géolocalisation-ip#migration#compatibilité#api

ipinfo.io a un style de réponse caractéristique : un champ loc qui combine la latitude et la longitude en une seule chaîne séparée par une virgule plutôt qu'en deux nombres distincts, et un champ org qui regroupe le numéro de système autonome et le nom de l'organisation, par exemple « AS15169 Google LLC » dans une seule chaîne. L'authentification se fait par jeton, et la réponse reste par ailleurs compacte et essentiellement plate, avec des champs comme city, region, country et postal à côté de ces deux champs combinés.

Ce formatage en chaînes combinées mérite d'être signalé spécifiquement, car le code qui analyse loc en le découpant sur la virgule, ou org en le découpant sur la première espace, effectue un vrai travail qui doit continuer de fonctionner correctement après une migration. C'est exactement le genre de petit détail d'analyse facile à négliger jusqu'à ce qu'une requête en production renvoie quelque chose que la logique de découpage n'attend pas.

L'hôte compatible ipinfo de My Geocode reproduit cette même structure compacte, y compris la chaîne combinée loc et la chaîne org préfixée par le numéro d'AS, le texte relatif aux droits d'auteur, aux conditions et à la confidentialité étant le seul contenu qui diffère. La référence se trouve sur /compatibility/ipinfo/. Une logique d'analyse construite autour du découpage de loc et org devrait continuer de fonctionner exactement telle qu'elle est écrite.

Les recherches d'IP font partie des endpoints pour lesquels on peut décrire directement de vrais résultats, et pas seulement le format. Une recherche sur une adresse donnée renvoie la ville, la région, le pays, la chaîne de coordonnées combinée et la chaîne d'organisation combinée, en direct plutôt que depuis un cache périmé, car les données de géolocalisation IP de My Geocode sont tenues à jour par une couche de cache qui se rafraîchit au lieu de vieillir.

Points de migration à prévoir :

  • L'authentification par jeton correspond à nos quatre modes pris en charge : en-tête X-API-Key, en-tête Authorization: Bearer, authentification HTTP Basic ou paramètre de requête
  • Des extras facultatifs (signaux de menace IP, informations réseau plus détaillées) s'ajoutent au format compact standard lorsqu'ils sont demandés avec mg_extras=1 ou un en-tête X-MG-Extras, sans casser les champs que votre code lit déjà
  • La consommation du quota est visible dans les en-têtes de réponse de chaque appel, notamment X-Quota-Used et X-Credits-Remaining, ce qui est utile si votre intégration actuelle suit l'utilisation manuellement

Tarifs : 2 500 requêtes gratuites par jour sans clé, 2 500 autres requêtes gratuites par clé et par jour, décomptées par réseau, puis du crédit prépayé à 0,0001 € par requête ou une clé Unlimited à 50 € par mois, chaque endpoint, y compris cet hôte compatible, étant facturé au même prix. Pour les applications construites autour du format compact propre à ipinfo pour la journalisation, l'analyse ou les décisions d'accès, l'objectif de cette migration est que le format lui-même n'ait jamais à changer, seulement ce qui le sert.

Plus d'articles sur la migration