Guía rápida

Antes de empezar

• Una cuenta de Watch-IP — el plan gratuito es suficiente para seguir esta guía.
• Una página o script al que puedas agregar una llamada fetch o curl.

1. Crea una cuenta y obtén una clave

Regístrate y abre tu panel. Cada cuenta empieza con una clave publicable de visitante — configura sus orígenes permitidos para incluir el sitio desde el que la llamarás (o localhost mientras haces pruebas).

2. Realiza tu primera solicitud

Llama a GET /v1/geo con tu clave publicable en el encabezado X-Api-Key. Desde un navegador, esto resuelve la propia conexión del visitante; desde un servidor, resuelve la conexión del propio servidor en su lugar.

curl https://api.watch-ip.com/v1/geo \
  -H "X-Api-Key: YOUR_PUBLISHABLE_KEY"

3. Lee la respuesta

Una llamada exitosa devuelve 200 con un cuerpo JSON — country, city y timezone son los campos con los que la mayoría de las integraciones empiezan, y cada campo es nulo de forma independiente, así que verifícalo antes de usarlo.

{
  "ip": "203.0.113.1",
  "country": "US",
  "city": "Austin",
  "timezone": "America/Chicago"
}

4. Busca una IP diferente

¿Necesitas resolver una dirección que ya tienes, en lugar del visitante que se conecta? Ese es un endpoint independiente de servidor a servidor autenticado con una clave secreta, no tu clave publicable — consulta la referencia de búsqueda de IP.

Si algo sale mal

Un 401 significa que la clave de API falta o es inválida; un 403 de GET /v1/geo generalmente significa que el origen que llama aún no está en la lista de orígenes permitidos de la clave. Consulta errores y límites de tasa para ver la lista completa de códigos de estado.

Siguiente paso

Lee autenticación para saber cómo funcionan los tipos de clave y la restricción por origen, o ve directamente a la referencia de endpoints para la respuesta con la que estás integrando.