Guides développeur pour l'API Billabex
Des tutoriels complets sur l'authentification, la pagination, les limites de débit et les bonnes pratiques d'intégration.
Démarrage
Introduction rapide à l'API Billabex : s'authentifier et faire son premier appel.
Authentification OAuth Billabex
Flux d'autorisation OAuth 2.1 par code avec PKCE, et OpenID Connect en option.
Scopes OAuth
Comprendre les scopes disponibles, comment l'accès est contrôlé, et comment demander les bonnes permissions pour votre intégration.
Erreurs JSON
Interpréter les erreurs de l'API Billabex par leur code, suivre la piste de résolution, et ne réessayer que lorsque la réponse l'autorise.
Serveur MCP Billabex
Connecter un outil IA à Billabex par le Model Context Protocol (MCP), avec OAuth 2.1.
Préférences de notification
Lire et modifier les préférences de notification de l'utilisateur authentifié.
Limites de débit
Comprendre le modèle de limitation par jeton OAuth, pourquoi il est conçu ainsi, et ce que votre intégration doit implémenter.
Journal d'audit
Lire qui a fait quoi dans une organisation : une entrée par commande réussie, filtrable par compte, par acteur et par texte libre.
Pagination et filtres
Comprendre la pagination par curseur de Billabex et le paramètre filters, et ce que votre intégration doit implémenter.
Sources de compte
Relier et délier une source de données externe à un compte, par API.
Facture d’origine d’un avoir
Relier un avoir à sa facture d’origine sans créer d’allocation ni modifier les soldes.
Opérations upsert
Créer ou mettre à jour une ressource en une seule requête idempotente.
Contacts
Gérer les contacts clients rattachés à un compte.
Envoi de fichiers
Envoyer les fichiers de factures, d'avoirs et de pièces jointes d'email, en binaire ou en base64.
Tâches de compte et interactions
Répondre aux tâches ouvertes par l'agent Billabex : rechercher, lister, consulter, annuler, mettre de côté, et ajouter une interaction.
Envoyer un SMS ou un courrier
Prévisualiser, chiffrer et envoyer une relance payante sans créer de doublon.
Lire la balance âgée
Analyser les encours nets par ancienneté, devise et compte client.
Vous ne trouvez pas ce que vous cherchez ?
Parcourez la référence complète de l'API pour le détail des endpoints, ou écrivez au support développeur.