IP-Adressen im Batch abfragen

Senden Sie eine Liste von IP-Adressen an einen Endpoint und erhalten Sie eine passende Liste von Standortergebnissen. Die IP-Massenabfrage-API von Watch-IP akzeptiert bis zu 100 IPv4- und IPv6-Adressen pro Anfrage für Backend-Anreicherungs-Workflows. Bewahren Sie Ihren geheimen Schlüssel auf dem Server auf, verarbeiten Sie die Antwort in Eingabereihenfolge, und behandeln Sie fehlende Einträge, ohne den Bezug zu Ihren ursprünglichen Daten zu verlieren.

Abfrage-Tarife ansehen Einzel-IP-Abfrage vergleichen →

Eine Anfrage, bis zu 100 Adressen

Verwenden Sie POST /v1/lookup mit einem JSON-Objekt, das ein ips-Array enthält. Jeder akzeptierte Batch enthält mindestens eine und höchstens 100 Adressen, und Sie können gültige IPv4- und IPv6-Adressen in derselben Liste mischen. Die Antwort verpackt die geordneten Abfrageergebnisse in einem results-Array; jedes Ergebnis verwendet dieselbe Struktur wie die Einzel-IP-Abfrage, einschließlich found und nullbarer Standortfelder.

Ergebnisse mit Ihren Quelldaten abgeglichen halten

Bei einem erfolgreichen Batch liefert die API ein Ergebnis für jede Eingabeadresse in derselben Reihenfolge. Bewahren Sie Ihre eigenen Datensatzkennungen neben der übermittelten Liste auf, damit Sie die Ergebnisse Ihren ursprünglichen Zeilen wieder zuordnen können. Wenn ein Eintrag nicht gefunden wird, behalten Sie die Zeile und markieren Sie den Standort als nicht verfügbar; wenn nur ein Feld fehlt, behalten Sie den Rest des Ergebnisses bei. Ersetzen Sie fehlende Koordinaten nicht durch 0, da dies eine fehlende Angabe in eine irreführende Kartenposition verwandeln würde.

Vor dem Absenden validieren

Eine leere Liste, eine Liste mit mehr als 100 Adressen oder eine fehlerhaft formatierte IP führt zu einem Anfragefehler — eine fehlerhafte Adresse lehnt den gesamten Batch ab, statt für die übrigen Eingaben ein Teilerfolgsergebnis zu liefern. Validieren Sie die Eingabe, teilen Sie längere Listen vor dem Senden in Batches auf, und führen Sie eine Aufzeichnung abgeschlossener Batches, damit eine Wiederholung nicht versehentlich einen ganzen Auftrag wiederholt.

Verstehen, was Batching ändert

Batching reduziert die Anzahl der HTTP-Anfragen, die zum Absenden einer Liste nötig sind. Es ändert nicht die Datenquelle, fügt keine Sicherheitsfelder hinzu und macht aus 100 Abfragen keine einzelne Nutzungseinheit — die Abfragenutzung wird pro übermittelter IP bei akzeptierten Anfragen erfasst, die Tarifwahl sollte also sowohl das gesamte Abfragevolumen als auch die Anfragerate berücksichtigen. Die Ratenbegrenzung pro Minute zählt HTTP-Aufrufe, nicht Einträge: Ein Batch mit bis zu 100 IPs oder E-Mail-Adressen zählt als eine Anfrage, während jeder Eintrag weiterhin einzeln auf das monatliche Anfragekontingent angerechnet wird.

Struktur von Anfrage und Antwort

ips: Anfrage-Body: ein JSON-Array mit 1–100 IPv4- oder IPv6-Adressen.
results: Antwort: ein geordnetes Array mit einem Eintrag pro Eingabeadresse, in der übermittelten Reihenfolge.
results[].found, results[].country, ...: Jedes Ergebnis verwendet dieselbe Struktur und Nullbarkeit wie die Einzel-IP-Abfrageantwort — siehe die IP-Abfrage-Produktseite.

Eine Batch-Anfrage senden

cURL — POST /v1/lookup

curl --fail-with-body \
  'https://api.watch-ip.com/v1/lookup' \
  --header "Authorization: Bearer ${WATCH_IP_SECRET_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{"ips":["8.8.8.8","2001:4860:4860::8888"]}'

Diese Beispieladressen implizieren keine bestimmten aktuellen Standortwerte. Legen Sie zunächst WATCH_IP_SECRET_KEY in der Umgebung Ihres Servers fest.

Häufig gestellte Fragen

Wie viele IP-Adressen passen in einen Batch?

Das aktuelle Maximum liegt bei 100. Teilen Sie längere Listen in Anfragen mit jeweils 1–100 Adressen auf.

Kann ein Batch sowohl IPv4 als auch IPv6 enthalten?

Ja. Jede Adresse muss gültig sein, und die Datenbankabdeckung kann je nach Adresse unterschiedlich sein.

Werden Ergebnisse in Eingabereihenfolge zurückgegeben?

Ja. Ein erfolgreicher, akzeptierter Batch liefert ein Ergebnis pro Eingabeadresse in derselben Reihenfolge.

Was passiert, wenn eine IP fehlerhaft formatiert ist?

Die gesamte Anfrage wird abgelehnt. Validieren Sie Ihre Eingabe vor dem Absenden — dieser Endpoint bietet keinen Teilerfolg für fehlerhafte Eingaben.

Wird ein Batch als eine Abfrage abgerechnet?

Nein. Die Nutzung wird pro IP gemessen. Prüfen Sie die aktuelle Abfrage-Preisgestaltung und verifizierte Abrechnungsbeispiele, bevor Sie die Kosten eines großen Auftrags schätzen.

Kann ich eine CSV-Datei hochladen?

Der dokumentierte Endpoint akzeptiert ein JSON-Array von Adressen. Ihre Anwendung kann ihre eigene CSV lesen und Batches übermitteln; eine gehostete CSV-Upload-Oberfläche ist nicht Teil dieser API.

Enthält die Massenabfrage VPN- oder Tor-Prüfungen?

Nein. Die aktuelle Massenantwort ist das Standortergebnis einer Geolokalisierungsdatenbank eines Drittanbieters. Sicherheitsindikatoren der Besucher-Geolokalisierung sind eine separate Fähigkeit, die in Abfrageantworten nicht vorhanden ist.