Watch-IP

Referencia de la API de bulk IP lookup

POST/v1/lookup

Versión en lote de GET /v1/lookup/{ip}: resuelve hasta 100 direcciones IPv4/IPv6 en una sola solicitud de backend, devueltas en el mismo orden en que se enviaron.

Autenticación

Proporciona una clave secreta mediante Authorization: Bearer YOUR_SECRET_KEY, el mismo tipo de clave que el endpoint de lookup de una sola IP.

Cuerpo de la solicitud

ips
Un arreglo de 1 a 100 cadenas de direcciones IPv4/IPv6. Todo el lote se valida antes de que se ejecute cualquier consulta: una dirección malformada hace fallar toda la llamada.

Errores

400
Un arreglo ips vacío, más de 100 IP, o una IP malformada en cualquier punto del arreglo.
401
Clave de API faltante o no válida.
403
Se usó una clave publicable en lugar de una clave secreta.
429
Límite de tasa superado para la ventana de un minuto actual.

Ejemplo

Solicitud

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"]}'

Respuesta

{
  "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 }
  ]
}

Límites

Cada IP del lote se factura y se registra individualmente: una llamada de 100 IP registra 100 eventos de uso de lookup, no uno. Una IP duplicada enviada dos veces se factura dos veces. Para el límite de tasa por minuto, la llamada completa cuenta como una sola solicitud. Los datos de ubicación de este endpoint los proporciona DB-IP (IP Geolocation by DB-IP, db-ip.com — CC BY 4.0).

Páginas relacionadas