API BCE : exemples d’appels en cURL, JavaScript et Python
Exemples API BCE prêts à copier : fiche d’entreprise, recherche par nom ou adresse, validation de TVA via VIES et codes NACE, en cURL, JavaScript et Python.
Des recettes prêtes à copier-coller pour les tâches les plus courantes. Chaque appel est authentifié (voir Authentification).
Récupérer une entreprise#
curl https://companybelgium.be/api/v2/enterprise/1033.022.383 \
-H "X-API-Key: $API_BCE_KEY" \
-H "X-API-Secret: $API_BCE_SECRET"Recherche par nom d’entreprise#
curl "https://companybelgium.be/api/v2/denominations?q=espero&limit=5" \
-H "X-API-Key: $API_BCE_KEY" -H "X-API-Secret: $API_BCE_SECRET"Recherche par adresse#
curl "https://companybelgium.be/api/v2/search/address?postalCode=1080&street=Colonne" \
-H "X-API-Key: $API_BCE_KEY" -H "X-API-Secret: $API_BCE_SECRET"Valider un numéro de TVA européen#
curl "https://companybelgium.be/api/v2/vat/BE1033022383" \
-H "X-API-Key: $API_BCE_KEY" -H "X-API-Secret: $API_BCE_SECRET"Rechercher des codes d’activité NACE#
curl "https://companybelgium.be/api/v2/naces?q=programmation&version=2008&limit=10" \
-H "X-API-Key: $API_BCE_KEY" -H "X-API-Secret: $API_BCE_SECRET"Vous préférez explorer de façon interactive ? Ouvrez le Playground API et lancez de vraies requêtes depuis votre navigateur.
Assembler les exemples API BCE en un flux complet#
Chaque recette de cette page répond à une tâche isolée. Dans une vraie application, elles s’enchaînent. Prenons l’onboarding d’un nouveau client professionnel. D’abord, l’utilisateur tape quelques lettres et vous proposez des noms via /denominations. Ensuite, il choisit une entreprise et vous chargez la fiche complète avec /enterprise/{num}. Enfin, vous validez son numéro de TVA via /vat/{vatNumber} avant d’ouvrir le compte.
Ce flux en trois appels couvre la plupart des formulaires B2B. De plus, il réduit les erreurs de saisie et garantit une adresse conforme au registre.
D’autres scénarios courants#
- Prospection locale : listez les entreprises d’une rue avec
/search/address, puis filtrez sur leur statut. - Segmentation CRM : retrouvez un code NACE avec
/naces, puis comparez-le aux activités de vos clients. - Contrôle de facture entrante : validez le numéro de TVA du fournisseur avant de comptabiliser la facture.
- Analyse de crédit : avec API Pro, lisez
/enterprise/{num}/financialpour les comptes annuels et les ratios.
Adapter les exemples pour la production#
Les exemples restent volontairement courts. Avant de les déployer, ajoutez donc trois éléments. Premièrement, une lecture systématique du code HTTP et du champ error. Deuxièmement, un nouvel essai avec backoff exponentiel sur les réponses 429 et 5xx. Troisièmement, un délai d’attente raisonnable sur chaque requête, pour qu’un appel lent ne bloque pas votre interface.
Par ailleurs, les exemples lisent la clé dans des variables d’environnement. Conservez ce principe : ne remplacez jamais ces variables par des valeurs écrites en dur. Pour tester sans risque, pointez plutôt les mêmes exemples vers l’API de test avec une clé pk_test_.
Tester les exemples API BCE sur des cas limites#
Un exemple qui fonctionne sur une entreprise active ne prouve pas grand-chose. Rejouez donc chaque recette sur les numéros du mode test. Par exemple, la fiche 0999.999.427 montre une personne physique sans comptes annuels. De même, 0999.999.328 renvoie une entreprise arrêtée. Vérifiez ensuite que votre interface affiche ces cas correctement. Enfin, testez la recherche par adresse avec une rue très courante : vous verrez comment se comporte la pagination quand les résultats sont nombreux.
Questions fréquentes sur les exemples API BCE#
Existe-t-il des exemples dans d’autres langages ?
Cette page fournit cURL, JavaScript et Python. Pour un autre langage, générez un client depuis la spécification OpenAPI, ou traduisez les requêtes HTTP, qui restent très simples.
Puis-je lancer ces exemples sans compte ?
Oui, depuis le bac à sable avec la clé de démo. Celle-ci est toutefois limitée à 15 requêtes toutes les 10 minutes et aux données publiques du registre.
Pourquoi le numéro 1033.022.383 revient-il partout ?
C’est le numéro de l’éditeur, ESPERO-SOFT INFORMATIQUES. Les exemples utilisent ainsi une entreprise réelle sans exposer celle d’un tiers.