Pour interagir avec l'API Workvivo, un jeton Bearer doit être inclus dans l'en-tête de toutes les demandes. Cet article te guidera tout au long de la procédure à suivre pour :
- Création d'une application dans Workvivo
- Ajouter les autorisations/champs d'application nécessaires
- Générer le jeton Bearer
Appareil (s) : ordinateur de bureau
Rôles/autorisations : développeur
Disponibilité : Accès à l'API activé à la demande du support
S'il te plaît, note ce qui suit :
- Pour utiliser l'API Workvivo, tu dois d'abord contacter le support pour demander l'accès à l'API.
-
Workvivo demande à tout utilisateur interagissant avec notre API de se voir attribuer d'abord le rôle de développeur. Cette tâche peut être exécutée par l'administrateur de ton compte une fois que l'accès à l'API aura été accordé. Voir (Attribuer des rôles) dans Workvivo. )
Une fois le rôle de développeur attribué, l'utilisateur aura accès à une option supplémentaire dans le panneau d'administration : « Clés API et paramètres JWT ». Ce paramètre permet aux utilisateurs de créer une application, d'ajouter/supprimer des zones d'intégration et de générer un jeton porteur en suivant les étapes ci-dessous.
1. Administration ouverte & « Cliquez » sur « Clés API et paramètres JWT»
2. « Cliquez » pour ajouter une nouvelle application
3. Donnez à ton application les autorisations et les champs d'application nécessaires et donnez-lui un nom. C'est le bon moment pour consulter la documentation de l'API et identifier les autorisations requises pour chaque point de terminaison. Par exemple, pour interagir avec l'API Teams, tu devras appliquer toutes les autorisations de lecture/écriture d'équipe requises.
Si je ne sais pas quelles autorisations sont requises à ce stade, ne t'inquiète pas, il sera possible de faire des mises à jour plus tard, une fois l'application en ligne.
4. Maintenant que l'application a été créée, « clique » sur « Gérer les clés ».
5. « Cliquez » sur Ajouter une nouvelle clé. Une fois que la nouvelle clé aura été nommée, le jeton Bearer s'affichera.
Sauvegarde le jeton dans un endroit sûr car il ne pourra pas être récupéré une fois la fenêtre fermée. Si le jeton Bearer est compromis à tout moment, supprime-le immédiatement et crée-en une nouvelle clé.
Informations supplémentaires
- À titre de référence : documentation de Workvivo pour les développeurs
- Pour me rappeler que l'accès à l'API n'est pas activé pour tous les comptes Workvivo, veuillez donc en faire la demande auprès du support.