Watch-IP

Autenticación

Watch-IP usa dos tipos de clave según el endpoint que llames: una clave publicable, segura para el navegador, para las llamadas del lado del cliente, y una clave secreta, exclusiva del servidor, para las llamadas del backend. Enviar el tipo incorrecto devuelve 401 o 403, nunca una respuesta parcial.

Claves publicables (seguras para el navegador)

Se usa para GET /v1/geo y POST /v1/email/validate, ambos diseñados para llamarse directamente desde el navegador de un visitante. Envíala en el encabezado X-Api-Key (GET /v1/geo también acepta un parámetro de consulta key como alternativa). No es un secreto: se envía dentro del JavaScript de tu página, y el control que realmente importa es la lista de orígenes permitidos configurada para la clave, verificada contra el encabezado Origin/Referer de la solicitud. Una solicitud desde un origen que no está en esa lista recibe un 403 sin ningún encabezado CORS configurado: el navegador bloquea la respuesta antes de que tu código llegue a verla, y esa es la aplicación real del control, no el cuerpo JSON del error.

Clave publicable

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

Claves secretas (solo servidor)

Se usa para GET /v1/lookup/{ip}, POST /v1/lookup y POST /v1/risk/check, todos endpoints de servidor a servidor sin ningún Origin de navegador que verificar. Envíala como Authorization: Bearer YOUR_SECRET_KEY únicamente desde tu propio backend; nunca incluyas una clave secreta en una página, en el paquete de una app móvil ni en ningún cliente que no controles. Usar una clave publicable en una ruta de clave secreta, o una clave secreta en una ruta de clave publicable, devuelve 403.

Clave secreta

curl https://api.watch-ip.com/v1/lookup/203.0.113.1 \
  -H "Authorization: Bearer YOUR_SECRET_KEY"

Límite de tasa

Cada clave tiene un límite de tasa por cuenta de cliente en una ventana fija de un minuto, compartida entre todos los endpoints que llames en lugar de contabilizarse por ruta. Superarlo devuelve 429; consulta errores y límites de tasa para conocer la forma de la respuesta y cómo esperar antes de reintentar. El límite de tasa por minuto cuenta llamadas HTTP, no elementos: un lote de hasta 100 IP o direcciones de correo cuenta como una sola solicitud, mientras que cada elemento sigue contando por separado en el límite mensual de solicitudes.

Dominios personalizados

Los planes Growth y Scale incluyen una vía de configuración de dominio personalizado en el panel, de modo que las solicitudes pueden dirigirse a un nombre de host de tu propio dominio en lugar de api.watch-ip.com. La disponibilidad depende de la elegibilidad de la cuenta y de una configuración de DNS/SSL exitosa; dirige tu integración a la URL base que tu panel confirme como activa.

Páginas relacionadas