Skip to Content
Référence APIAuthentification

Authentification

Obtenir une Clé API

Tu peux créer une Clé API sur la page Intégrations API  dans l’interface d’administration Ignite. Tu dois avoir un rôle admin pour accéder à cette page.

Lorsque tu crées une clé, choisis ses permissions et un périmètre de catégories optionnel.

Permissions

Les permissions d’une Clé API sont accordées par ressource. Active uniquement les actions dont ton intégration a besoin.

RessourceActions disponibles
Vidéosread, create, update, delete, publish
Événements liveread, create, update, delete, publish
Tagscreate, update, delete
Catégoriescreate, update, delete
Analyticsread

L’accès en lecture aux catégories et aux tags est toujours accordé. Tu n’as pas besoin de l’activer.

publish est distinct de create et update. Pour les vidéos, définir ou modifier visibility en public nécessite videos.publish. Sans cela, les nouvelles vidéos restent private et les mises à jour de visibilité sont rejetées.

Les endpoints Analytics nécessitent analytics.read. La permission read sur les vidéos ne suffit pas. Voir Analytics.

Les Clés API ne peuvent pas gérer les membres, les webhooks, les autres intégrations API ni les paramètres du compte.

Périmètre de catégories

Tu peux limiter une Clé API à une ou plusieurs catégories. Si tu sélectionnes des catégories, la clé ne peut accéder qu’aux vidéos de ces catégories et de leurs sous-catégories. Si tu laisses le champ vide, la clé peut accéder à toutes les catégories de l’espace de travail.

Le périmètre de catégories s’applique aux vidéos et aux appels Analytics par vidéo. Il ne limite pas l’accès aux événements live.

Utiliser une Clé API

Passe ta Clé API comme Jeton Bearer dans l’en-tête Authorization de ta requête.

curl -X GET https://app.ignitevideo.cloud/api/videos \ -H "Authorization: Bearer YOUR_API_KEY"