Watch-IP

Referencia de la API de IP Lookup

GET/v1/lookup/{ip}

Resuelve una única dirección IPv4 o IPv6 que tú proporciones, usando una base de datos de geolocalización de IP y ASN de terceros: una fuente de datos y una forma de respuesta distintas de GET /v1/geo. Exclusivamente de servidor a servidor; llámala desde tu backend, nunca desde un navegador.

Autenticación

Proporciona una clave secreta mediante Authorization: Bearer YOUR_SECRET_KEY. A diferencia de la clave publicable que usa GET /v1/geo, esta clave debe permanecer en tu servidor; usar una clave publicable aquí devuelve 403.

Campos de la respuesta

ip
La dirección IP que proporcionaste, devuelta tal cual.
country, city, continent
Ubicación aproximada de la base de datos fuente, o null cuando no está disponible.
region
Un código de subdivisión (p. ej., "TX"), no un nombre de región: una forma distinta del campo region de GET /v1/geo.
postalCode, timezone
No los completa la fuente de datos actual: siempre son null.
latitude, longitude
Coordenadas aproximadas, o null cuando no están disponibles.
found
False cuando la IP no tiene ningún registro coincidente o la base de datos subyacente está temporalmente no disponible; este campo no distingue entre los dos casos.

Errores

400
La IP proporcionada no es una dirección IPv4 o IPv6 válida.
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/203.0.113.1 \
  -H "Authorization: Bearer YOUR_SECRET_KEY"

Respuesta

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

Límites

Se factura por IP consultada, de forma independiente al volumen de solicitudes de tu plan de geo de visitantes; consulta la página del producto de IP lookup para conocer precios y disponibilidad. ¿Necesitas más de una IP por llamada? Usa en su lugar el endpoint por lotes. 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