Watch-IP

API-Referenz zur IP-Massenabfrage

POST/v1/lookup

Batch-Version von GET /v1/lookup/{ip} — löst bis zu 100 IPv4-/IPv6-Adressen in einer einzigen Backend-Anfrage auf, zurückgegeben in derselben Reihenfolge, in der sie übermittelt wurden.

Authentifizierung

Stellen Sie einen geheimen Schlüssel über Authorization: Bearer YOUR_SECRET_KEY bereit, denselben Schlüsseltyp wie beim Endpoint für die Einzel-IP-Abfrage.

Anfragetext

ips
Ein Array aus 1–100 IPv4-/IPv6-Adress-Strings. Der gesamte Batch wird validiert, bevor eine Abfrage ausgeführt wird — eine einzige fehlerhafte Adresse lässt den gesamten Aufruf fehlschlagen.

Fehler

400
Ein leeres ips-Array, mehr als 100 IPs oder eine fehlerhafte IP irgendwo im Array.
401
Fehlender oder ungültiger API-Schlüssel.
403
Es wurde ein veröffentlichbarer statt eines geheimen Schlüssels verwendet.
429
Ratenlimit für das aktuelle Ein-Minuten-Fenster überschritten.

Beispiel

Anfrage

curl https://api.watch-ip.com/v1/lookup \
  -H "Authorization: Bearer YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ips": ["203.0.113.1", "2001:db8::1"]}'

Antwort

{
  "results": [
    { "ip": "203.0.113.1", "country": "US", "region": "TX", "city": "Austin", "postalCode": null, "latitude": 30.2672, "longitude": -97.7431, "continent": "NA", "timezone": null, "found": true },
    { "ip": "2001:db8::1", "country": null, "region": null, "city": null, "postalCode": null, "latitude": null, "longitude": null, "continent": null, "timezone": null, "found": false }
  ]
}

Limits

Jede IP im Batch wird einzeln abgerechnet und erfasst — ein Aufruf mit 100 IPs erfasst 100 Lookup-Nutzungsereignisse, nicht eines. Eine zweimal übermittelte doppelte IP wird zweimal abgerechnet. Für die Ratenbegrenzung pro Minute zählt der gesamte Aufruf als eine Anfrage. Standortdaten für diesen Endpoint werden von DB-IP bereitgestellt (IP Geolocation by DB-IP, db-ip.com — CC BY 4.0).

Verwandte Seiten