Pour les développeurs
Vue d'ensemble de l'API
Comment fonctionne l'API HTTP : adresse, format des réponses et bonnes pratiques.
L'API de Mon IP est du HTTP pur. Chaque outil du site a une route GET que vous pouvez appeler depuis n'importe quel langage, script ou automatisation.
Adresse de base
https://meuip.juk.re/api
Aucune clé d'API ni inscription.
Format
- Toutes les routes utilisent GET, avec les paramètres dans la query string.
- Les réponses sont en JSON, sauf le ping (texte en temps réel) et /api/ip?format=text (texte brut).
- Les erreurs contiennent un champ error avec l'explication.
Langue des messages
Envoyez l'en-tête x-lang (pt, en, es ou fr) ou Accept-Language pour recevoir les messages d'erreur dans la langue de votre choix.
Bonnes pratiques
- Mettez en cache ce qui change peu, comme le DNS et le WHOIS.
- Après un 429, attendez le délai de l'en-tête Retry-After avant de réessayer.
- Définissez un timeout dans votre client : certaines requêtes dépendent du serveur cible.
- Identifiez votre service avec un User-Agent à vous.
Sur la page Developers, vous voyez des exemples dans 8 langages et pouvez exécuter chaque appel tout de suite.