Watch-IP

Authentification

Watch-IP utilise deux types de clés selon le point de terminaison appelé — une clé publiable, sûre pour le navigateur, pour les appels côté client, et une clé secrète, réservée au serveur, pour les appels backend. Envoyer le mauvais type renvoie 401 ou 403, jamais une réponse partielle.

Clés publiables (sûres pour le navigateur)

Utilisée pour GET /v1/geo et POST /v1/email/validate — toutes deux conçues pour être appelées directement depuis le navigateur d'un visiteur. Envoyez-la dans l'en-tête X-Api-Key (GET /v1/geo accepte aussi un paramètre de requête key en repli). Ce n'est pas un secret : elle apparaît dans le JavaScript de votre page, et le contrôle qui compte est la liste des origines autorisées configurée pour la clé, vérifiée par rapport à l'en-tête Origin/Referer de la requête. Une requête provenant d'une origine absente de cette liste reçoit un 403 sans en-tête CORS — le navigateur bloque la réponse avant même que votre code ne la voie, ce qui constitue l'application réelle du contrôle, pas le corps JSON de l'erreur.

Clé publiable

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

Clés secrètes (réservées au serveur)

Utilisée pour GET /v1/lookup/{ip}, POST /v1/lookup et POST /v1/risk/check — des points de terminaison serveur à serveur, sans Origin de navigateur à vérifier. Envoyez-la en Authorization: Bearer YOUR_SECRET_KEY depuis votre propre backend uniquement ; n'intégrez jamais une clé secrète dans une page, un pack d'application mobile ou un client que vous ne contrôlez pas. Utiliser une clé publiable sur une route à clé secrète, ou une clé secrète sur une route à clé publiable, renvoie 403.

Clé secrète

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

Limitation de débit

Chaque clé est limitée en débit par compte client sur une fenêtre fixe d'une minute, partagée entre tous les points de terminaison que vous appelez plutôt que suivie par route. La dépasser renvoie 429 — voir erreurs et limites de débit pour la forme de la réponse et la marche à suivre pour patienter. La limite de débit par minute compte les appels HTTP, pas les éléments : un lot de jusqu'à 100 IP ou adresses e-mail compte pour une seule requête, tandis que chaque élément compte toujours séparément dans le plafond mensuel de requêtes.

Domaines personnalisés

Les forfaits Growth et Scale incluent un parcours de configuration de domaine personnalisé dans le tableau de bord, afin que les requêtes puissent aboutir sur un nom d'hôte de votre propre domaine plutôt que api.watch-ip.com. La disponibilité dépend de l'éligibilité du compte et de la réussite de la configuration DNS/SSL — pointez votre intégration vers l'URL de base que votre tableau de bord confirme comme active.

Pages associées