Der Standort ist oft nur ein Teil dessen, was an einer IP-Adresse wichtig ist. Ob diese Adresse mit bekannten Bedrohungsaktivitäten in Verbindung steht und zu welcher Art von Netzwerk sie tatsächlich gehört, kann für Betrugsprävention, Zugriffskontrolle oder allgemeine Risikobewertung genauso wichtig sein. /v1/ip liefert jetzt genau diese Informationen als optionales Extra, verfügbar, wann immer Sie danach fragen.
Wenn Sie einer Anfrage mg_extras=1 hinzufügen oder einen X-MG-Extras-Header senden, werden IP-Bedrohungs- und Netzwerkdetails zusätzlich zur Standard-Standortantwort geliefert, ohne dass sich an den bereits zurückgegebenen Basisfeldern etwas ändert. Lassen Sie dieses Flag weg, ist die Antwort genau so wie immer. Fügen Sie es hinzu, liefert derselbe Aufruf zusätzliche Details neben den Standortfeldern, die Sie bereits erhalten.
Derselbe Mechanismus gilt auch für die Geländehöhe, sodass mg_extras=1 ein einziger, einheitlicher Weg ist, über verschiedene Endpunkte hinweg zusätzliche Tiefe anzufordern, statt eines eigenen Flags pro Funktion. Er gilt auch für unsere Kompatibilitätshosts: Eine Anfrage im Format von ip-api.com, ipinfo.io oder ipstack kann dasselbe Flag oder denselben Header zusätzlich zu ihrem ansonsten exakt nachgebildeten Anfrage- und Antwortformat verwenden und erhält so Bedrohungs- und Netzwerkdetails, ohne die Kompatibilität mit dem ursprünglichen Format zu verlieren.
Der Preis hängt nicht davon ab, ob Extras angefordert werden. Eine Abfrage mit mg_extras=1 zählt als dieselbe einzelne Anfrage gegen Ihr kostenloses Kontingent, Ihr Prepaid-Guthaben oder Ihr Unlimited-Paket wie eine Abfrage ohne. Es gibt keine separate, teurere Stufe für die zusätzlichen Details und kein eigenes Kontingent, das Sie speziell für Extras im Blick behalten müssten.
Das richtet sich klar an Anwendungsfälle, in denen der Standort allein nicht ausreicht. Eine Anwendung, die Registrierungen auf verdächtige Aktivitäten prüft, ein Dienst, der entscheidet, ob für eine bestimmte Verbindung eine zusätzliche Verifizierung nötig ist, oder ein Sicherheitstool, das ein umfassenderes Bild der Netzwerkreputation aufbaut, können diesen Kontext direkt aus demselben /v1/ip-Aufruf beziehen, den sie ohnehin schon ausführen, statt nur für dieses eine Element eine zweite Integration mit einem separaten Anbieter für Bedrohungsdaten zu pflegen.
Die vollständige Dokumentation der IP-Endpunkte, einschließlich der Frage, wie Sie Extras hinzufügen, finden Sie unter /docs/ipv4-lookup/ und /docs/ipv6-lookup/. Da die Funktion vollständig optional ist, testen Sie sie mit einer bestehenden Integration, indem Sie einem Aufruf, den Sie bereits ausführen, einfach ein Flag hinzufügen.