La localisation n'est souvent qu'une partie de ce qui compte à propos d'une adresse IP. Savoir si cette adresse est associée à une activité malveillante connue, et à quel type de réseau elle appartient réellement, peut compter tout autant pour la prévention de la fraude, le contrôle d'accès ou l'évaluation générale des risques. /v1/ip renvoie désormais exactement ces informations en option, disponibles dès que vous les demandez.
Ajouter mg_extras=1 à une requête, ou envoyer un en-tête X-MG-Extras, superpose des informations sur les menaces et le réseau à la réponse de localisation standard, sans rien changer aux champs de base déjà renvoyés. Sans ce paramètre, la réponse est exactement la même qu'avant. Avec lui, le même appel renvoie des informations supplémentaires à côté des champs de localisation que vous recevez déjà.
Ce même mécanisme s'applique aussi à l'altitude du sol : mg_extras=1 est donc une manière unique et cohérente de demander davantage de détails sur différents endpoints, plutôt qu'un paramètre distinct pour chaque fonctionnalité. Il s'applique également à nos hôtes compatibles : une requête au format ip-api.com, ipinfo.io ou ipstack peut ajouter le même paramètre ou le même en-tête à son format de requête et de réponse par ailleurs strictement identique, et obtenir les informations sur les menaces et le réseau sans rompre la compatibilité avec le format d'origine.
Le prix ne dépend pas de la demande d'extras. Une recherche avec mg_extras=1 compte comme la même requête unique sur votre quota gratuit, votre crédit prépayé ou votre forfait Unlimited qu'une recherche sans ce paramètre. Il n'existe pas de palier distinct et plus cher pour ces informations supplémentaires, ni de quota séparé à suivre spécifiquement pour les extras.
Cette fonctionnalité vise directement les cas d'usage où la localisation seule ne suffit pas. Une application qui filtre les inscriptions pour repérer une activité suspecte, un service qui décide s'il faut imposer une vérification supplémentaire à une connexion donnée, ou un outil de sécurité qui construit une vue plus large de la réputation des réseaux peuvent tous obtenir ce contexte directement depuis le même appel /v1/ip qu'ils effectuent déjà, plutôt que de maintenir une seconde intégration avec un fournisseur distinct de renseignements sur les menaces pour cette seule information.
La documentation complète des endpoints IP, y compris la manière d'ajouter les extras, est disponible sur /docs/ipv4-lookup/ et /docs/ipv6-lookup/. Comme la fonctionnalité est entièrement facultative, la tester sur une intégration existante se résume à ajouter un paramètre à un appel que vous effectuez déjà.