Perk utilise l'API Yokoy pour la gestion des dépenses. L'API Yokoy est une API REST qui permet aux comptes de soumettre des dépenses, de consulter des transactions et de gérer des factures dans Perk. Seuls les administrateurs de compte peuvent demander des identifiants pour l'API Yokoy.
Conseil: Vous découvrez l'API Spend ? Consultez Développeur Yokoy.
Les identifiants API sont liés au compte. Cela signifie qu'ils ont autorisations de modification des données de référence pour différentes entités juridiques.
Lorsque vous demandez des identifiants API, vous recevez l'ID client et le secret client qui servent à générer un jeton d'accès pour l'API Spend. Ce jeton d'accès est indispensable pour authentifier tous les appels à l'API. Vous aurez également besoin de l'ID de votre organisation. Vous trouverez cette information en haut à droite de l'interface. Outils de développement > Outils de gestion des dépenses.
Pour générer un jeton d'accès dans l'API, voir Authentification et autorisationLes identifiants API sont valides pour l'ensemble de l'organisation, quel que soit l'utilisateur qui soumet les appels.
Vous pouvez générer les identifiants API dans l'onglet Identifiants d'accès.
Génération des identifiants API
Pour générer des identifiants API pour l'API Yokoy :
- Allez à Outils de développement > Outils de gestion des dépenses. Dans le Identifiants d'accès onglet, pour créer de nouvelles informations d'identification API, cliquez Générer des identifiants.
-
Choisir Identifiants OAuth et cliquez Générer des identifiants.
- Saisissez un nom pour décrire les identifiants API. Ce nom vous permet d'identifier ces identifiants. doit Soyez unique. Vous ne pouvez pas continuer tant qu'un nom unique n'a pas été saisi. Cliquez Suivant.
- Copiez le ID client et Secret client Veuillez les conserver en lieu sûr (dans un fichier protégé). Ces identifiants sont uniques et irrécupérables. Conservez-les dans un endroit sécurisé pour toute utilisation ultérieure. Pour continuer, vous devez confirmer avoir copié l'identifiant et le mot de passe.
Les identifiants API n'expirent pas. Vous pouvez les révoquer à tout moment pendant cette période. En cas de perte de vos identifiants API, vous devez révoquer l'accès et en générer de nouveaux.
Vous pouvez générer plusieurs identifiants API pour les utiliser dans différentes applications. Ces identifiants ne sont pas automatiquement révoqués si vous en générez plusieurs.
La page des outils de développement Spend affiche toutes les informations d'identification API générées ou révoquées, y compris l'utilisateur qui a demandé les informations d'identification et la date à laquelle elles ont été demandées.
Révocation de l'accès
Pour révoquer l'accès fourni par les identifiants API :
- Dans la page des outils de développement Spend, cliquez sur l'action Révoquer l'accès.
- Cliquez Révoquer l'accès pour confirmer et supprimer le jeton.
Prudence: Si vous révoquez l'accès, les autres applications ou scripts utilisant ces identifiants ne pourront plus accéder aux données Spend. Par conséquent, les identifiants API apparaissent désormais sur la page des outils de développement Spend avec le statut : Révoqué et le nom de l'utilisateur qui l'a révoquée ainsi que la date de révocation.