Connectez Spendesk à vos autres outils métier ou créez une intégration partenaire à l'aide de l'API Spendesk. Cet article couvre les ressources pour développeurs, la configuration des identifiants et les prérequis.
Pour : les Account Owners sur le plan Premium (clients) et les partenaires technologiques développant des intégrations avec Spendesk.
Table des matières
Avant de commencer
Découvrir le portail développeur de l'API
Créer des identifiants API
Mettre en œuvre l'accès à l'API
Dépannage
Avant de commencer
👥 Seuls les Account Owners peuvent créer et gérer les identifiants API dans Spendesk.
Découvrir le portail développeur de l'API
Commencez par explorer le portail développeur dédié à l'API Spendesk. Vous y trouverez :
La documentation
Le journal des modifications (changelog)
La collection Postman
La gestion des webhooks
Si vous développez une intégration comptable pour récupérer les données de dépenses depuis Spendesk, vous aurez besoin d'accéder aux fonctionnalités suivantes :
Récupérer les factures fournisseurs (payables)
Récupérer les pièces jointes des factures fournisseurs
Récupérer les règlements (settlements)
Récupérer les frais bancaires
Récupérer les rechargements de compte (wallet loads)
Récupérer le résumé du compte (wallet summary)
Récupérer les membres
Récupérer les fournisseurs
Récupérer les champs et valeurs analytiques
Récupérer les centres de coûts
Récupérer les catégories de dépenses
Créer des identifiants API
Contactez l'équipe commerciale de Spendesk, directement ou via le support client Spendesk, pour demander l'accès à l'API. Une fois autorisé, gérez vos identifiants API dans Paramètres > Intégrations > Gérer l'accès API.
Les identifiants API permettent aux développeurs de se connecter à votre entité Spendesk et de récupérer ou modifier des informations, selon les permissions que vous accordez.
🔒 L'accès à l'API est disponible uniquement sur le plan Premium.
Mettre en œuvre l'accès à l'API
Suivez ces étapes pour créer un nouveau Client ID et Client Secret :
Accédez à Paramètres > Intégrations > Gérer l'accès API
Cliquez sur Créer une nouvelle clé
Saisissez un nom pour cet accès API
Saisissez une description pour cet accès API, indiquant son objectif afin de faciliter son identification ultérieure
Sélectionnez une date d'expiration (jusqu'à un an à partir d'aujourd'hui)
Sélectionnez les permissions (scopes) à accorder à cet ensemble d'identifiants
Cochez la case pour reconnaître que ces identifiants donneront accès aux fonctionnalités et données sélectionnées
Cliquez sur Créer une clé API
Une fois que vous cliquez sur Créer une clé API, une fenêtre affiche votre Client ID et votre Client Secret.
⚠️ Vous ne verrez le Client Secret en clair qu'une seule fois. Il ne peut pas être récupéré à nouveau — si vous le perdez, vous devrez générer un nouvel ensemble d'identifiants.
💡 Lorsque vous partagez des identifiants avec une équipe de développement externe, choisissez la période d'expiration la plus courte possible (par exemple, un mois). Vous pourrez toujours créer de nouveaux identifiants plus tard avec la même durée de validité ou une durée plus longue. Les identifiants existants ne peuvent pas être prolongés — vous devez en créer de nouveaux.
Dépannage
Symptôme : Vous ne voyez pas l'option « Gérer l'accès API » dans Paramètres > Intégrations.
Cause : Votre entreprise n'est pas sur le plan Premium, ou vous n'avez pas encore été autorisé à accéder à l'API.
Résolution : Contactez le support client Spendesk ou votre account manager pour demander l'accès à l'API. Vérifiez le plan de votre entreprise dans Paramètres > Facturation.
Symptôme : Vous avez perdu votre Client Secret.
Cause : Le Client Secret n'est affiché qu'une seule fois, lors de sa création, et ne peut pas être récupéré ensuite.
Résolution : Générez un nouvel ensemble d'identifiants API en répétant les étapes de la section Mettre en œuvre l'accès à l'API. Révoquez les anciens identifiants inutilisés.
Symptôme : Vous ne pouvez pas créer une nouvelle clé API.
Cause : Vous n'êtes pas l'Account Owner de votre entité Spendesk.
Résolution : Demandez à votre Account Owner actuel de créer les identifiants, ou de vous transférer le rôle d'Account Owner.
📋 Stockez les identifiants API dans un coffre-fort de mots de passe sécurisé et ne les partagez jamais par messagerie ou par e-mail. Vérifiez régulièrement les identifiants stockés et révoquez ceux qui ne sont plus utilisés.