API Excellent Banking : Authentification, Endpoints et première requête

Nous sommes ravis d’ouvrir une nouvelle façon de travailler avec Excellent Banking : une API REST qui vous permet d’analyser, de catégoriser et d’exporter des relevés bancaires directement depuis vos propres applications, scripts ou workflows.

Pour les développeurs, les comptables gérant plusieurs clients ou les entreprises qui doivent traiter des relevés à grande échelle, l’API supprime le besoin de téléversements manuels via l’application web. Tout fonctionne par de simples requêtes HTTP.

Ce que l’API vous permet de faire

L’API couvre essentiellement le même pipeline que vous connaissez dans l’application web — mais entièrement automatisé :

Téléversez des relevés par programmation depuis votre backend ou vos scripts d’automatisation
Déclenchez le traitement et recevez des données de transaction structurées en JSON
Téléchargez des fichiers Excel catégorisés prêts pour la comptabilité, l’analyse ou l’import dans vos outils
Vérifiez l’état du traitement pour créer des workflows fiables et pilotés par événements

Vous gardez le contrôle total. L’API ne prend pas de décisions à votre place — elle vous fournit la sortie structurée, et vous décidez quoi en faire.

Authentification

Tous les appels API sont authentifiés avec des clés API. Voici comment cela fonctionne :

Obtenez votre clé depuis votre tableau de bord Excellent Banking. Chaque compte en reçoit une.
Incluez-la dans l’en-tête Authorization de chaque requête.
Renouvelez-la si nécessaire — vous pouvez générer de nouvelles clés à tout moment depuis le tableau de bord. Les anciennes clés sont immédiatement invalidées.

C’est tout. Pas de danse OAuth, pas de logique de rafraîchissement de token, pas de gestion complexe de session. Une clé, un en-tête, et vous êtes connecté.

Les clés sont limitées à votre compte, ce qui signifie que vous ne pouvez voir et gérer que vos propres fichiers. Si vous avez besoin d’un accès au niveau de l’équipe ou de comptes de service, contactez-nous.

Les principaux endpoints

L’API suit les conventions REST. Voici un aperçu conceptuel de ce qui est disponible :

Ressource	Description
Relevés	Téléverser des relevés bancaires (PDF, CSV, image), consulter l’historique, supprimer des fichiers
Traitement	Déclencher l’extraction et la catégorisation d’un fichier téléversé
Résultats	Récupérer les transactions traitées en JSON, télécharger l’export Excel
Crédits	Vérifier votre solde actuel, consulter l’historique d’utilisation
Compte	Gérer votre profil et vos clés API

Chaque réponse est en JSON. Chaque endpoint renvoie des codes de statut clairs, des messages d’erreur explicites et une pagination cohérente lorsque c’est pertinent.

Nous gardons la surface réduite et concentrée. L’objectif est une poignée d’endpoints bien conçus qui couvrent les vrais workflows — pas un catalogue tentaculaire difficile à naviguer.

Votre première requête

Voici à quoi ressemble un flux d’intégration typique :

Authentifiez-vous — incluez votre clé API dans l’en-tête de la requête
Téléversez — envoyez un relevé bancaire (PDF, CSV ou image) via une seule requête multipart
Vérifiez le statut — le traitement s’exécute en asynchrone. Interrogez l’endpoint de statut ou attendez les notifications
Récupérez les résultats — une fois le traitement terminé, obtenez les données de transaction structurées en JSON
Exportez — demandez un fichier Excel si votre workflow en a besoin

L’ensemble du flux se résume à trois requêtes : téléverser, vérifier le statut, récupérer les résultats. Si vous préférez un tableur, ajoutez un quatrième appel pour l’export Excel.

Des exemples de code détaillés pour Python, JavaScript et cURL sont disponibles dans la documentation de l’API. La documentation inclut des constructeurs de requêtes interactifs, vous permettant de tester les endpoints directement dans votre navigateur avant d’écrire du code.

Tarification pour l’utilisation de l’API

Les appels API consomment des crédits du même solde que celui que vous utilisez dans l’application web. Il n’y a pas de tarification API distincte ni de facturation mesurée au-delà de ce que vous connaissez déjà :

Un relevé traité = un ou deux crédits (selon la taille)
Les mêmes packs de crédits que vous connaissez : 5 € pour 50, 20 € pour 200, 50 € pour 700
Les crédits n’expirent jamais, que vous les utilisiez dans l’application ou via l’API
Vérifiez votre solde à tout moment via l’endpoint des crédits

Cela signifie que vous pouvez mélanger les usages — téléverser certains relevés via l’interface web, automatiser le reste via l’API. Même compte, mêmes crédits, aucune surprise.

Confidentialité et traitement des données

Les mêmes garanties de confidentialité qui s’appliquent à l’application web s’étendent à l’API :

Toutes les données restent dans l’UE (Allemagne et Suisse)
Conformité totale au RGPD
Vos données ne sont jamais utilisées pour l’entraînement
Suppression complète disponible sur demande à tout moment
Les clés API sont transmises exclusivement via HTTPS

Si vous développez des intégrations qui traitent des données bancaires, vous pouvez être sûr que notre infrastructure respecte les normes européennes de protection des données.

Quelles sont les prochaines étapes pour l’API ?

Il s’agit de la première version de l’API, et nous l’améliorons activement en fonction des retours. Sur la feuille de route à court terme :

Webhooks pour que votre intégration n’ait pas besoin d’interroger le statut en continu
Traitement par lots pour soumettre plusieurs relevés en un seul appel
Plus de formats de sortie au-delà d’Excel et JSON
Règles de catégorisation personnalisées que vous pouvez appliquer via l’API

L’API est conçue pour évoluer avec vos besoins. Si une fonctionnalité ou un endpoint spécifique vous serait utile, faites-le nous savoir.

Démarrez

Rendez-vous sur votre tableau de bord, récupérez votre clé API et consultez la documentation complète. Votre première requête est à quelques minutes.

Si vous rencontrez un problème ou avez des questions, nous sommes joignables à hello@excellent-banking.com.