Remarques préliminaires
Un jeton d'accès à l'API est une caractéristique de mappage unique permettant de récupérer, de modifier ou de créer les données de l'entreprise via l'API. Les jetons d'API peuvent être générés à des fins différentes et se voir attribuer des autorisations différentes. Les équipes de développeurs ont besoin de jetons d'accès à l'API pour programmer des intégrations à Frisbii Media, entre autres. Les jetons d'accès à l'API peuvent également être créés pour différents cas d'utilisation, tels que l'accès par des applications tierces ou des membres de l'équipe.
Dans la liste, la colonne Statut indique si le jeton est actif ou expiré. La colonne Âge du jeton indique depuis combien de temps le jeton est actif.
plus de 6 mois - le symbole de statut est activé. Le nombre de jours est en orange.
plus d'un an - le symbole de statut est activé. Le nombre de jours est en rouge.
Jeton expiré- le symbole d'état est défini sur <0>Expiréavec un fond rouge.
Note : Pour des raisons de sécurité, nous recommandons de renouveler le jeton manuellement sur une base régulière ou d'utiliser l'option de renouvellement automatique.
Créer un jeton d'accès à l'API
Cliquez sur +Créer un nouveau jeton API.
Attribuez le nom* du jeton.
Saisissez une description facultative.
Les droits d'accès* déterminent si le jeton est autorisé à lecture et à écriture ou à lecture uniquement.
Déterminez les applications* à l'aide du menu déroulant. Ils déterminent les applications pour lesquelles le jeton peut être utilisé.
Expire le : Une date d'expiration du jeton peut être définie ici. Dès que le jeton expire, l'accès au système Frisbii Media est bloqué.
Case à cocher Renouvellement automatique tous les x jours : Si elle est activée, le jeton est automatiquement renouvelé et un rappel peut être défini pour informer un système tiers.
E-mail du destinataire auquel il convient d'envoyer l'information selon laquelle le jeton a été automatiquement renouvelé.
Paramètres de callback
Un callback peut être mis en place pour transférer l'information à un système tiers que le jeton d'accès à l'API a été renouvelé. Les callbacks ne doivent être mis en place que si le renouvellement automatique du jeton a été activé. Le callback transmet une clé unique qui doit être échangée par l'intermédiaire de l'API.
endpoint /apiAccessTokens/requestRenewedToken dans les 2 heures afin de recevoir le token mis à jour. Si la clé unique n'a pas été échangée dans les 2 heures, un nouveau callback est déclenché après 24 heures. Une fois que la clé unique a été utilisée, l'ancien jeton est encore valable pendant 24 heures avant d'expirer.
Gérer les jetons d'accès à l'API
Le jeton peut être géré soit dans la liste de droite via Action, soit dans la vue détaillée via la barre d'action en haut.
Note : Le jeton ne peut être renouvelé que dans la vue détaillée.
Copier le jeton
Cliquez sur Copier dans la vue détaillée sous le jeton.
Le jeton est copié dans le cache et peut être inséré ailleurs.
Désactiver
Cliquez sur Désactiver.
Dans la boîte de dialogue, il est rappelé que la désactivation ne peut être annulée.
Si vous souhaitez réellement désactiver le jeton d'accès à l'API, cliquez sur Désactiver.
Modifier
Le jeton d'accès à l'API peut être modifié dans une certaine mesure. Les éléments suivants peuvent être modifiés :
Description
Renouvellement automatique
Destinataire de l'e-mail
Paramètres de callback
Renouveler le jeton
Dans la vue détaillée de la barre d'action, le jeton peut être renouvelé manuellement via Renouveler le jeton. Les éléments suivants doivent/peuvent être définis dans la boîte de dialogue :
La date de fin du jeton existant* détermine la date d'expiration du jeton existant.
Nom du nouveau jeton* détermine le nom du nouveau jeton.
Une description peut être ajoutée.
Documentation de l'API Frisbii Media
La documentation de l'API Frisbii Media contient toutes les informations nécessaires sur la manière dont l'API peut être utilisée avec Frisbii Media.
Point de terminaison de l'API pour les jetons d'accès : /apiAccessTokens/requestRenewedToken