API BCE : tester les requêtes en ligne, sans inscription
Bac à sable API BCE : envoyez de vraies requêtes depuis votre navigateur avec la clé de démo, des données de test fictives ou votre propre clé.
Utiliser le bac à sable API BCE efficacement#
Le bac à sable sert à comprendre une réponse avant d’écrire la moindre ligne de code. Par exemple, un chef de projet peut vérifier les champs disponibles pour un écran. De son côté, un développeur valide un paramètre avant de l’intégrer. Trois modes sont proposés, et chacun répond à un usage différent.
- Clé de démo : sans inscription, 15 requêtes toutes les 10 minutes, données publiques du registre uniquement.
- Données de test : entreprises fictives de l’API de test, idéales pour voir une faillite ou un quota dépassé.
- Ma clé : vos propres identifiants, avec les données et les quotas de votre formule.
Scénarios à explorer#
D’abord, passez en mode données de test et appelez 0999.999.229. Vous verrez à quoi ressemble une ouverture de faillite. Ensuite, essayez 0999.999.526 pour observer une réponse 429. Ces deux cas sont difficiles à provoquer avec de vraies entreprises. Enfin, comparez le temps de réponse affiché entre une fiche complète et une sous-ressource.
Par ailleurs, certains endpoints demandent votre propre clé. C’est le cas des endpoints liés à votre compte. Le bac à sable vous l’indique avant l’envoi.
Sécurité et limites#
Votre clé et votre secret restent dans l’onglet du navigateur (sessionStorage). Ils ne sont transmis à l’API que pour la requête envoyée et ne sont jamais conservés. Cependant, évitez d’utiliser une clé de production sur un poste partagé. Préférez une clé dédiée aux essais, ou le mode données de test. De plus, les requêtes envoyées avec votre clé consomment votre quota comme n’importe quel appel.
Du bac à sable à votre code API BCE#
Le bac à sable est un point de départ, pas une fin. Une fois la requête validée, reproduisez-la donc dans votre code avec votre propre clé. Ensuite, comparez la réponse obtenue avec celle du bac à sable : la structure doit être identique. Par ailleurs, gardez une trace des numéros et des paramètres testés. Ils serviront ensuite de jeux d’essai pour vos tests automatisés. Enfin, si une réponse vous surprend, consultez la fiche de référence de l’endpoint. Elle décrit en effet chaque paramètre et donne un exemple de réponse.
Questions fréquentes sur le bac à sable API BCE#
Pourquoi la clé de démo est-elle refusée ?
Elle est partagée et limitée à 15 requêtes toutes les 10 minutes. Quand la démo est très sollicitée, réessayez quelques secondes plus tard ou utilisez votre propre clé.
Le bac à sable remplace-t-il le mode test ?
Non. Il sert à explorer à la main. Pour des tests automatisés, appelez plutôt l’API de test depuis votre code avec une clé pk_test_.
Puis-je reproduire une requête dans mon code ?
Oui. Chaque réponse peut être copiée, et les exemples montrent la même requête en cURL, JavaScript et Python.