Documentation de l'API
Cartelis normalise, valide et géocode des adresses françaises. Une requête HTTP, une réponse JSON, pas de SDK obligatoire.
Tous les services sont opérationnels
· base adresse mise à jour le 2 août 2026
Démarrage
La base de l'API est https://api-fr.safeeclipse.online/v1/. Toutes les réponses
sont en JSON UTF-8. Les requêtes doivent être faites en HTTPS.
# normaliser une adresse curl "https://api-fr.safeeclipse.online/v1/adresses?q=14+rue+de+la+fonderie+toulouse" \ -H "Authorization: Bearer VOTRE_CLE"
Authentification
Chaque appel doit porter un en-tête Authorization: Bearer avec votre
clé. Les clés se créent depuis l'espace client et peuvent être
restreintes par domaine appelant ou par plage d'adresses IP.
Ne mettez pas votre clé dans du code côté navigateur.
Pour les usages front-end, créez une clé publique restreinte par
Referer : elle n'ouvre que /v1/autocompletion et son quota
est compté séparément.
Points d'entrée
| Point d'entrée | Description | Coût |
|---|---|---|
GET/v1/adresses |
Normalisation et géocodage d'une adresse libre | 1 crédit |
GET/v1/autocompletion |
Suggestions au fil de la frappe, 5 résultats maximum | 0,2 crédit |
GET/v1/inverse |
Géocodage inverse à partir de coordonnées | 1 crédit |
POST/v1/lots |
Traitement par lot, CSV jusqu'à 50 000 lignes | 0,6 / ligne |
GET/v1/lots/{id} |
État et résultat d'un lot | gratuit |
Exemple de réponse
{
"query": "14 rue de la fonderie toulouse",
"resultats": [
{
"libelle": "14 Rue de la Fonderie, 31000 Toulouse",
"code_insee": "31555",
"code_postal": "31000",
"coordonnees": { "lat": 43.5966, "lon": 1.4419 },
"score": 0.97
}
]
}
Codes d'erreur
| Code | Signification | Que faire |
|---|---|---|
| 400 | Paramètre q absent ou vide | Vérifier la requête |
| 401 | Clé absente ou révoquée | Régénérer depuis l'espace client |
| 403 | Origine non autorisée pour cette clé | Ajouter le domaine appelant |
| 429 | Quota par seconde dépassé | Respecter l'en-tête Retry-After |
| 503 | Maintenance planifiée | Voir la page statut |
