API CodaBill
Tout ce que fait l'interface CodaBill est disponible par API REST : fichiers CODA, comptes, transactions, conversions et webhooks. Base : https://api.codabill.com/v1.
Démarrage en 60 secondes
curl https://api.codabill.com/v1/ping \ -H "Authorization: Bearer cb_test_votre_cle"
Créez vos clés dans app.codabill.com/api-keys : cb_test_ pour le bac à sable, cb_live_ pour la production (plan Scale).
Endpoints principaux
| Méthode | Chemin | Description |
|---|---|---|
| GET | /v1/coda | Liste des fichiers CODA (curseur) |
| GET | /v1/coda/{id}/download | Téléchargement du fichier |
| GET | /v1/clients | Dossiers clients |
| GET | /v1/accounts | Comptes bancaires et soldes |
| GET | /v1/accounts/{id}/transactions | Mouvements normalisés |
| POST | /v1/conversions | Convertir un document en CODA |
| POST | /v1/webhooks | Créer une destination de webhook |
Webhooks signés
Chaque livraison porte l'en-tête CodaBill-Signature: t=<timestamp>,v1=<hmac> : HMAC-SHA256 de timestamp.corps avec votre secret whsec_. Événements : coda.delivered, consent.expiring, connection.broken, coda.missing.
Limites
120 requêtes/minute par clé. Réponses paginées par curseur (next_cursor). Les erreurs suivent {"error": {"code", "message"}}.