CheckIP.ca

Documentation de l’API

L’API renvoie l’IP publique et les métadonnées Cloudflare de la connexion qui effectue la requête. Aucun compte ni clé API n’est nécessaire.

Point d’accès JSON

curl https://checkip.ca/api/ip

Utilisez GET pour le JSON. HEAD renvoie les mêmes en-têtes sans corps. Les autres méthodes retournent 405 Method Not Allowed. Le point d’accès et les noms de champs sont identiques dans les deux langues.

Exemple de réponse

{
  "ip": "203.0.113.42",
  "type": "IPv4",
  "country": "CA",
  "city": "Regina",
  "region": "Saskatchewan",
  "timezone": "America/Regina",
  "asn": 64500,
  "isp": "Example Network",
  "colo": "YYZ"
}

Ces valeurs sont des exemples de documentation, pas les données du lecteur.

Champs

ip: Adresse publique présentée par la requête.
type: IPv4 ou IPv6 selon le format de l’adresse.
country: Code de pays à deux lettres.
city: Ville approximative.
region: Région approximative.
timezone: Fuseau horaire fourni par Cloudflare.
asn: Numéro de système autonome, sous forme numérique si disponible.
isp: Organisation réseau.
colo: Code du centre de données Cloudflare.

Les champs absents utilisent Unknown.

En-têtes

Cache-Control: private, no-store
Access-Control-Allow-Origin: *
X-Robots-Tag: noindex

Les réponses ne doivent pas être mises en cache publiquement. L’API ne nécessite pas d’identifiants et permet les requêtes simples depuis d’autres origines.

Texte et versions IP

curl https://checkip.ca
curl --ipv4 https://checkip.ca
curl --ipv6 https://checkip.ca

Les clients en ligne de commande reconnus reçoivent l’adresse seule avec un saut de ligne. Les options --ipv4 et --ipv6 choisissent la version utilisée pour la connexion.

Limites

L’API décrit uniquement la connexion du demandeur. Elle ne permet pas de rechercher une IP arbitraire et ne fournit ni historique, ni recherche en masse, ni garantie de disponibilité. Les résultats peuvent varier avec les VPN, mandataires et réseaux partagés.