Les jetons API sont des identifiants uniques qui permettent aux services tiers de communiquer de manière sécurisée avec une application ou un système. Les jetons API sont souvent utilisés dans des scénarios d’intégration où il est nécessaire d’établir une communication entre la plateforme Staffbase et des applications ou systèmes tiers. Vous pouvez créer des jetons API dans le Studio pour permettre à des services tiers d’établir une communication avec la plateforme Staffbase. Vous pouvez ensuite utiliser ces jetons pour demander l’accès à la plateforme Staffbase. Il est possible de créer des jetons API avec différents niveaux d’autorisations d’accès.

Créer un jeton API

Vous pouvez créer un jeton API en spécifiant le niveau d’accès requis. De plus, vous pouvez définir des adresses IP spécifiques ou des plages CIDR (Classless Inter Domain Routing) autorisées à utiliser le jeton API. Ce paramètre permet de limiter l’exposition du jeton et de réduire le risque d’utilisation non autorisée. 

1. Dans le Studio, accédez à Paramètres > Accès à l’API.
2. Cliquez sur Créer un jeton API.
   La page Jetons API s’ouvre.
3. Cliquez sur Créer un jeton API.
   La boîte de dialogue Créer un jeton API s’ouvre.
4. Dans le champ Nom du jeton, indiquez un nom.

5. Sélectionnez un niveau d’accès. 

   Le niveau d’accès requis pour l’API dépend du cas d’utilisation métier. Par exemple, l’accès Lecture seule restreinte suffit pour les flux RSS, tandis que les intégrations avancées nécessitent un accès Administratif. 
6. Optionnel : développez Avancé pour définir les plages d’IP autorisées.
7. Dans le champ Plages d’IP autorisées, saisissez les adresses IP ou plages CIDR autorisées à utiliser ce jeton.
8. Cliquez sur Créer.
   Le jeton API est créé. La page d’aperçu des jetons API s’ouvre.
   Vous avez créé un jeton API avec succès. Vous pouvez maintenant récupérer le jeton que vous venez de créer.
    

Récupérer le jeton API

Une fois le jeton API créé, vous devez le récupérer. Pour l’utiliser, vous pouvez ensuite le copier dans votre presse-papiers.

1. Dans le Studio, accédez à Paramètres > Accès à l’API.
   La page Jetons API s’ouvre.

2. Cliquez sur l’icône de copie à côté du jeton API pour le copier dans votre presse-papiers.

   

   
   Vous avez copié un jeton API. Vous pouvez utiliser ce jeton API copié pour établir une communication entre des services tiers et la plateforme Staffbase.