Skip to Content
Referencia APIAutenticación

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.

RecursoAcciones disponibles
Vídeosread, create, update, delete, publish
Eventos en vivoread, create, update, delete, publish
Tagscreate, update, delete
Categoríascreate, update, delete
Analyticsread

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 -X GET https://app.ignitevideo.cloud/api/videos \ -H "Authorization: Bearer YOUR_API_KEY"