Rechercher une adresse IP depuis votre backend

Résolvez une adresse IP fournie en données disponibles de pays, région, ville et coordonnées approximatives. L'API de recherche d'IP de Watch-IP accepte des entrées IPv4 et IPv6 et renvoie un résultat JSON reposant sur une base de données tierce de géolocalisation IP. Utilisez une clé API secrète sur votre serveur, et construisez votre application autour des correspondances explicites, des enregistrements manquants et des champs de localisation pouvant être null.

Voir les forfaits de recherche Discuter de l'accès à la recherche →

Fournir l'adresse à résoudre

Appelez GET /v1/lookup/{ip} avec une adresse IP collectée par votre application, authentifiée via Authorization: Bearer et une clé secrète. La recherche résout l'adresse indiquée dans l'URL plutôt que la connexion utilisée pour effectuer la requête, ce qui la rend adaptée aux traitements backend qui contiennent déjà des adresses IP, y compris pour le reporting et l'enrichissement régional. Vérifiez comment votre application obtient l'IP d'un utilisateur final avant de vous fier à des en-têtes transférés ; ne faites confiance qu'à la chaîne de proxy que vous contrôlez. Pour une intégration ordinaire de visiteur de site web, le point de terminaison de géolocalisation du navigateur offre une autre voie, avec une clé publiable et un enrichissement régional.

Passer d'une adresse à un lot

Si votre traitement contient plusieurs adresses IP, le point de terminaison de lot en accepte jusqu'à 100 en une seule requête et renvoie les résultats dans le même ordre. Il utilise la même forme de résultat de recherche et le même modèle d'authentification par clé secrète côté serveur. Le regroupement en lot change la façon dont vous envoyez les requêtes — l'usage de recherche reste mesuré par IP, donc un lot ne compte pas comme une seule unité d'usage de recherche.

Construire autour de données approximatives

Une IP peut représenter une passerelle partagée, un réseau d'hébergement, une sortie VPN ou une connexion d'opérateur mobile. Les enregistrements de localisation peuvent être incomplets ou différer selon les fournisseurs de données. Utilisez la recherche comme contexte pour l'adresse fournie, pas comme preuve de résidence ou d'identité d'une personne.

Champs de la réponse

ip: L'adresse d'entrée associée à ce résultat.
found: Indique si un enregistrement correspondant a été trouvé dans la base. False peut aussi signifier que la base est indisponible ou n'a pas été chargée — cela ne prouve pas que l'adresse n'a aucune donnée de localisation.
country, continent: Codes de pays et de continent, lorsqu'ils sont disponibles.
region: Un identifiant de subdivision issu du mappage actuel, pas toujours un nom de région complet.
city, latitude, longitude: Ville et coordonnées approximatives, lorsqu'elles sont disponibles dans la base source.
postalCode, timezone: Non renseignés par la source de données actuelle — toujours null.

Effectuer une requête côté serveur

cURL — GET /v1/lookup/{ip}

curl --fail-with-body \
  'https://api.watch-ip.com/v1/lookup/8.8.8.8' \
  --header "Authorization: Bearer ${WATCH_IP_SECRET_KEY}"

Définissez d'abord WATCH_IP_SECRET_KEY dans l'environnement de votre serveur. 8.8.8.8 est une adresse d'exemple syntaxiquement valide ; cet extrait ne garantit aucun pays, ville ou réponse particulière pour cette adresse.

Questions fréquentes

Puis-je utiliser cette API pour rechercher l'adresse IP de quelqu'un d'autre ?

Le point de terminaison accepte une adresse IP fournie et renvoie les données de localisation disponibles dans la base, pas le nom, l'adresse exacte ou l'identité d'une personne. N'utilisez que des données que vous êtes autorisé à traiter.

Prend-il en charge l'IPv6 ?

Le point de terminaison valide les entrées IPv4 et IPv6. Une adresse valide peut néanmoins ne pas avoir d'enregistrement en base ou manquer de certains champs de localisation.

La recherche inclut-elle le fuseau horaire, l'ASN ou la détection VPN ?

Non. La réponse de recherche actuelle n'inclut ni ASN ni indicateurs de sécurité, et sa source de base de données tierce ne renseigne pas les champs de fuseau horaire ou de code postal. Consultez séparément la géolocalisation du visiteur si son modèle basé sur le client connecté convient à votre application.

Puis-je envoyer la requête depuis du JavaScript navigateur ?

Non — n'exposez jamais une clé secrète de recherche dans du code navigateur. Effectuez les appels de recherche depuis votre backend, et utilisez le point de terminaison visiteur avec une clé publiable pour la géolocalisation directe depuis le navigateur.

Est-ce inclus avec une clé visiteur gratuite ?

Non. La recherche utilise une clé secrète et une famille de forfaits distinctes ; le forfait visiteur gratuit ne donne pas accès à la recherche côté serveur.

Que signifie found: false ?

La recherche n'a renvoyé aucun enregistrement correspondant. Dans l'implémentation actuelle, cela peut aussi se produire quand la base est indisponible ou n'a pas été chargée : affichez donc « Localisation indisponible » et distinguez ce résultat des erreurs d'entrée invalide, d'authentification ou de limite de débit.