Watch-IP

Démarrage rapide

Obtenez un appel GET /v1/geo fonctionnel en quelques minutes : créez une clé, effectuez une requête et lisez la réponse.

Avant de commencer

  • Un compte Watch-IP — le forfait gratuit suffit pour suivre ce guide.
  • Une page ou un script auquel vous pouvez ajouter un appel fetch ou curl.

1. Créer un compte et obtenir une clé

Inscrivez-vous et ouvrez votre tableau de bord. Chaque compte démarre avec une clé visiteur publiable — configurez ses origines autorisées pour inclure le site depuis lequel vous l'appellerez (ou localhost pendant les tests).

2. Effectuer votre première requête

Appelez GET /v1/geo avec votre clé publiable dans l'en-tête X-Api-Key. Depuis un navigateur, cela résout la connexion du visiteur lui-même ; depuis un serveur, cela résout plutôt la connexion du serveur lui-même.

curl

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

3. Lire la réponse

Un appel réussi renvoie 200 avec un corps JSON — country, city et timezone sont les champs par lesquels la plupart des intégrations commencent, et chaque champ peut être vide (null) indépendamment, donc vérifiez avant de l'utiliser.

Réponse (abrégée)

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

4. Rechercher une autre IP

Besoin de résoudre une adresse que vous avez déjà, plutôt que le visiteur connecté ? C'est un point de terminaison serveur à serveur distinct, authentifié avec une clé secrète et non votre clé publiable — voir la référence de recherche d'IP.

En cas de problème

Un 401 signifie que la clé API est manquante ou invalide ; un 403 depuis GET /v1/geo signifie généralement que l'origine appelante ne figure pas encore dans la liste des origines autorisées de la clé. Voir erreurs et limites de débit pour la liste complète des codes de statut.

Étape suivante

Lisez authentification pour comprendre le fonctionnement des types de clés et de la restriction par origine, ou allez directement à la référence du point de terminaison pour la réponse que vous intégrez.

Pages associées