Watch-IP

Référence de l'API de recherche d'IP groupée

POST/v1/lookup

Version par lots de GET /v1/lookup/{ip} — résout jusqu'à 100 adresses IPv4/IPv6 en une seule requête backend, renvoyées dans le même ordre que celui de leur soumission.

Authentification

Fournissez une clé secrète via Authorization: Bearer YOUR_SECRET_KEY, le même type de clé que le point de terminaison de recherche d'IP unique.

Corps de la requête

ips
Un tableau de 1 à 100 chaînes d'adresses IPv4/IPv6. Le lot entier est validé avant que la moindre recherche ne s'exécute — une seule adresse malformée fait échouer tout l'appel.

Erreurs

400
Un tableau ips vide, plus de 100 IP, ou une IP malformée n'importe où dans le tableau.
401
Clé API manquante ou invalide.
403
Une clé publiable a été utilisée au lieu d'une clé secrète.
429
Limite de débit dépassée pour la fenêtre d'une minute en cours.

Exemple

Requête

curl https://api.watch-ip.com/v1/lookup \
  -H "Authorization: Bearer YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ips": ["203.0.113.1", "2001:db8::1"]}'

Réponse

{
  "results": [
    { "ip": "203.0.113.1", "country": "US", "region": "TX", "city": "Austin", "postalCode": null, "latitude": 30.2672, "longitude": -97.7431, "continent": "NA", "timezone": null, "found": true },
    { "ip": "2001:db8::1", "country": null, "region": null, "city": null, "postalCode": null, "latitude": null, "longitude": null, "continent": null, "timezone": null, "found": false }
  ]
}

Limites

Chaque IP du lot est facturée et enregistrée individuellement — un appel de 100 IP enregistre 100 événements d'utilisation de recherche, pas un seul. Une IP en double soumise deux fois est facturée deux fois. Pour la limite de débit par minute, l'appel entier compte pour une seule requête. Les données de localisation de ce point de terminaison sont fournies par DB-IP (IP Geolocation by DB-IP, db-ip.com — CC BY 4.0).

Pages associées