Autenticación

Las operaciones protegidas de participantes en la API de VibeVO usan claves de API. La petición debe llevar una clave válida en una cabecera; la clave identifica al propietario y sus scopes determinan los endpoints permitidos. La excepción son las dos lecturas públicas del catálogo de creadores que se describen abajo.

Formato de la clave

vibevo_live_{prefix}.{secret}

• prefix — identificador público corto, visible en el panel.
• secret — la parte secreta. Se muestra solo una vez al crearla.

Crear una clave

Las claves se crean en el panel, en la página Ajustes — hay un bloque «Claves de API» al final. Le das un nombre, seleccionas los scopes, opcionalmente defines una caducidad y copias la clave completa (se muestra una sola vez).

Enviar la clave

Se admiten dos cabeceras equivalentes; usa cualquiera:

Authorization: Bearer vibevo_live_ab12cd.xxxxxxxxxxxxxxxx
X-API-Key: vibevo_live_ab12cd.xxxxxxxxxxxxxxxx

Scopes

Solo dos permisos generales — no se eligen permisos por recurso:

• read — cualquier GET (campañas, ofertas, analítica, publicaciones, creadores, cartera, enlaces de seguimiento, fábricas). Una clave siempre tiene read.
• write — cualquier escritura (fábricas de contenido, envío de vídeos).

Excepción: catálogo público de placements

Solo GET /api/v1/creator-catalog y GET /api/v1/creator-pages/{publicId} funcionan sin clave API. Devuelven la proyección segura publicada y no dan acceso a borradores ni operaciones de pedido.

Las operaciones de participantes usan /api/v1/public/. Las lecturas requieren scope read; crear, modificar, cargar y confirmar requiere scope write. Core también comprueba el rol, el propietario actual de la cuenta/canal y el acceso al pedido concreto. Write no concede acceso staff ni sustituye read.

Errores de autorización

• 401 Unauthorized — clave ausente, inválida, caducada o revocada.
• 403 Forbidden — clave válida pero sin el scope requerido por el endpoint.

Actualizado: 11 de julio de 2026