SDK pour Python et TypeScript
Deux bibliothèques clientes officielles encapsulent l'API : une pour Python et une pour TypeScript et JavaScript. Toutes deux suivent les mêmes règles :
- Des méthodes typées pour le géocodage, l'inverse, l'autocomplétion, la réparation, l'usage, la couverture et les fichiers par lot.
- La clé d'API est lue par défaut dans la variable d'environnement
ADDROVA_API_KEY. - Nouvelles tentatives automatiques sur
429 rate_limited, les erreurs 5xx et les erreurs réseau, en respectantRetry-After, avec un backoff exponentiel. Un dépôt de lot n'est jamais rejoué après une erreur serveur, car il n'est pas idempotent. - Des erreurs typées qui portent le statut, le
codestable et l'identifiant de requête, jamais l'adresse envoyée. geocodeenvoie l'adresse dans le corps d'unPOST, jamais dans l'URL, et les bibliothèques ne journalisent aucune adresse.
Distribution. Les bibliothèques sont propriétaires et ne sont pas encore publiées sur PyPI ni sur npm : on les installe depuis le dépôt. [À VÉRIFIER : publication sur PyPI et npm]
Rien dans l'API n'exige un SDK. Le démarrage rapide montre les mêmes appels en curl, Python et JavaScript, en HTTP simple.