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.
| Ressource | Actions disponibles |
|---|---|
| Vidéos | read, create, update, delete, publish |
| Événements live | read, create, update, delete, publish |
| Tags | create, update, delete |
| Catégories | create, update, delete |
| Analytics | read |
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
curl -X GET https://app.ignitevideo.cloud/api/videos \
-H "Authorization: Bearer YOUR_API_KEY"