Description rapide
EUne partie de nos données est mise à disposition via des API (Application Programming Interface, interfaces de programmation) : Liste de nos APIs.
Cette page décrit tous les points importants pour l’accès à nos API.
Description technique
Outils d’accès
Les accès sont exclusivement possibles via HTTPS. Tous les outils qui supportent HTTPS peuvent ainsi être utilisés (par exemple Postman, Bruno, curl, wget) ou les langages de programmation et les bibliothèques (Python requests, Java, JavaScript et bien d’autres).
URL des API
Les URL d’accès sont disponibles dans le catalogue de données (liste de nos API) et dans les pages du cookbook.
Clés API
Pour appeler l’API, il faut résoudre une clé API et l’inclure dans l’en-tête de la requête.
Obtenir de nouvelles clés d’API dans le gestionnaire d’API
Depuis le 3 mars 2025, les clés peuvent être obtenues via notre nouveau API Manager. (Les menus et le guide de l’utilisateur du gestionnaire d’API ne sont disponibles qu’en anglais).
Figure 1 : Page d’accueil du gestionnaire d’API.
Principales étapes:
- La condition préalable est de s’inscrire en indiquant son adresse e-mail, son nom, son prénom et son mot de passe.
- Ensuite, une ou plusieurs “applications” peuvent être créées.
- Dans la page d’aperçu du gestionnaire d’API, il est maintenant possible de sélectionner une API (“read more”, puis “access with this plan”) et de l’ajouter à une application (“Select an App”).
Une seule clé peut être obtenue par API.
Utilisation des clés dans l’en-tête de la requête (request header)
Lorsque l’API est appelée, un champ “Authorization” contenant la clé doit être inclus dans l’en-tête de la requête HTTPS (request header) :
"Authorization": "Bearer .... insérer ici la clé ...."Autres points importants à prendre en compte
Définir le User-Agent
En règle générale, un champ “User-Agent” doit également être fourni dans l’en-tête (header).
"<strong>User-Agent</strong>": "... n'importe quelle valeur ...."Tolérer des redirects
Certaines de nos API utilisent des redirections vers d’autres URL. Il convient donc de définir les options correspondantes dans l’outil concerné (par exemple allow_redirect=True ou similaire).
Activer la compression
Si possible, le client devrait toujours utiliser la compression de données. Le client devrait mentionner les formats qu’il maîtrise, par exemple pour zip, Brotli et Deflate avec une entrée :
"Accept-Encoding": "zip, br, deflate"Examples
bruno
Bild 2: Ajouter des champs “Header” dans l’outil API bruno.
curl
Anwendungsbeispiele
folgen…