Les identifiants API permettent aux développeurs de se connecter à votre entité Spendesk, de récupérer et de modifier les informations qu'elle contient en fonction des autorisations que vous avez accordées.
Vous pouvez désormais gérer vos accès API sous Paramètres > Intégrations > Gestion des accès API.
Créer une clé API / Un accès API
Pour créer un nouvel ID client API et un Secret Client (comme un login et un mot de passe), procédez comme suit :
Cliquez sur le bouton
Créer une clé API.Renseignez un nom et une description pour cet accès API. Il est important de mentionner dans quel but ces accès seront utilisés afin de pouvoir les identifier facilement plus tard (pensez à quelqu'un de nouveau qui arrive et qui essaie de comprendre l'utilité de chaque accès à l'API).
Choisissez une date d'expiration. La date d'expiration ne peut être postérieure à un an.
Si vous partagez ces identifiants avec une équipe de développeurs externe, fixez une date d'expiration aussi courte que possible. En cas de doute, commencez toujours par des périodes de validité plus courtes (par exemple, un mois) - vous pouvez toujours créer de nouvelles clés API, avec la même période de validité ou une période plus longue, en fonction du niveau de confiance que vous avez.
Il n'est pas possible de prolonger la validité des références API existantes - il faut en créer de nouvelles.
Sélectionnez les autorisations que vous souhaitez accorder à cette clé API. Notre liste de champs d'application continue de s'agrandir, elle comprend actuellement les éléments suivants :
Récupération des créances (Payables)
Récupération des justificatifs (pdf, jpeg...) des créances
Récupération des règlements
Récupération des frais bancaires
Récupération des approvisionnements du portefeuille
Récupération de l'aperçu du portefeuille
Récupération des utilisateurs (membres)
Récupération des fournisseurs
Récupération des champs analytiques
Récupération des centres de coût
Récupération des catégories de dépense
Cochez la case pour confirmer que les nouveaux identifiants API permettront d'accéder aux fonctions et aux données sélectionnées ci-dessus.
Visualiser son ID client et Secret Client
Une fois que vous aurez cliqué sur Créer une clé API, une fenêtre s'ouvrira avec un ID client et un secret client.
C'est le seul moment où vous verrez le secret client en clair - il n'est pas possible de le récupérer à nouveau ultérieurement.
Si vous perdez le secret client, vous devrez générer une nouvelle clé API.
🔥 Ces mots de passe doivent être conservés dans un coffre-fort sécurisé et ne jamais être communiqués par messagerie ou par email. 🔥