Autenticación
Obtener una Clave API
Puedes crear una Clave API en la página Integraciones API de la interfaz de administración de Ignite. Necesitas un rol admin para acceder a esta página.
Al crear una clave, elige sus permisos y un alcance opcional de categorías.
Permisos
Los permisos de la Clave API se conceden por recurso. Activa solo las acciones que tu integración necesita.
| Recurso | Acciones disponibles |
|---|---|
| Vídeos | read, create, update, delete, publish |
| Eventos en vivo | read, create, update, delete, publish |
| Tags | create, update, delete |
| Categorías | create, update, delete |
| Analytics | read |
El acceso de lectura a categorías y tags siempre está concedido. No necesitas activarlo.
publish es independiente de create y update. Para vídeos, establecer o cambiar visibility a public requiere videos.publish. Sin ello, los vídeos nuevos permanecen private y se rechazan las actualizaciones de visibilidad.
Los endpoints de Analytics requieren analytics.read. Solo read de vídeos no es suficiente. Consulta Analytics.
Las Claves API no pueden gestionar miembros, webhooks, otras integraciones API ni la configuración de la cuenta.
Alcance de categorías
Puedes limitar una Clave API a una o más categorías. Si seleccionas categorías, la clave solo puede acceder a los vídeos de esas categorías y sus subcategorías. Si dejas el campo vacío, la clave puede acceder a todas las categorías del espacio de trabajo.
El alcance de categorías se aplica a los vídeos y a las llamadas de Analytics por vídeo. No limita el acceso a eventos en vivo.
Usar una Clave API
Pasa tu Clave API como Token Bearer en el encabezado Authorization de tu solicitud.
CURL
curl -X GET https://app.ignitevideo.cloud/api/videos \
-H "Authorization: Bearer YOUR_API_KEY"