Que vous soyez un client Spendesk ou un partenaire souhaitant commencer à utiliser l'API Spendesk pour créer une intégration, cet article est fait pour vous :
Pour les clients, pour connecter Spendesk à votre écosystème d'outils financiers et professionnels.
Pour les partenaires, pour développer et étendre votre offre avec Spendesk.
Découvrir notre portail développeur API
Vous pouvez d'abord consulter notre portail développeur dédié à l'API Spendesk où vous trouverez toutes les informations pertinentes :
Documentation
Changelog
Collection Postman
Administration des webhooks
Si vous cherchez spécifiquement à créer une intégration comptable pour récupérer les données de dépenses depuis Spendesk, voici les fonctionnalités dont vous aurez besoin :
Retrieve payables
Retrieve payable attachments
Retrieve settlements
Retrieve bank fees
Retrieve wallet loads
Retrieve wallet summary
Retrieve members
Retrieve suppliers
Retrieve analytical fields and values
Retrieve cost centers
Retrieve expense categories
Mettre en œuvre l'accès API
Une fois que vous avez consulté notre portail développeur, vous devez contacter l'équipe commerciale de Spendesk soit directement, soit via notre support client. Ils vous autoriseront à accéder à l'API. Ensuite, vous pourrez gérer vos identifiants API sous Paramètres > Intégrations > Gestion des accès API.
Les identifiants API permettent aux développeurs de se connecter à votre entité Spendesk, de récupérer et de modifier des informations selon les permissions que vous accordez.
Prérequis :
Vous devez être sous le plan tarifaire 'Premium' ou 'Enterprise'.
Vous devez être le Propriétaire du compte sur Spendesk pour créer des identifiants API.
Implementing API access
Afin de créer un nouveau client ID et client secret API, assurez-vous de respecter les prérequis puis suivez ces étapes :
Cliquez sur Créer une nouvelle clé.
Entrez un nom et une description pour cet accès API. Il est important de mentionner l'objectif de ces identifiants afin que quiconque puisse facilement les identifier ultérieurement.
Choisissez une date d'expiration. La date d'expiration ne peut pas être supérieure à un an à compter d'aujourd'hui. Mais si vous partagez ces identifiants avec une équipe de développement externe, faites-la aussi courte que pratiquement possible. En cas de doute, commencez toujours par des périodes de validité plus courtes (par exemple un mois) - vous pourrez toujours créer de nouveaux identifiants API ultérieurement, avec la même période de validité ou plus longue. Cependant, il n'est pas possible de prolonger la validité des identifiants API existants - de nouveaux doivent être créés.
Sélectionnez les permissions que vous souhaitez accorder à cet ensemble d'identifiants.
Cochez la case pour reconnaître que les nouveaux identifiants API donneront accès aux fonctionnalités et données sélectionnées ci-dessus. Il est important de noter que les permissions doivent s'aligner strictement sur les besoins d'utilisation pour minimiser les risques et garantir des opérations API sécurisées.
Une fois que vous cliquez sur Créer une clé API, vous verrez une fenêtre modale avec un client ID et un client secret. C'est le seul moment où vous verrez le client secret en clair - il n'est pas possible de le récupérer à nouveau.
Remarques importantes :
Si vous perdez le client secret, vous devrez générer un nouvel ensemble d'identifiants.
Stockez les identifiants API dans un coffre-fort de mots de passe sécurisé et ne les partagez jamais par messagerie/e-mail. De plus, il est recommandé d'effectuer des examens périodiques des identifiants stockés et de révoquer ceux qui ne sont plus utilisés.