Autenticación

La API pública de VibeVO usa claves de API. Cada petición debe llevar una clave válida en una cabecera. La clave identifica al propietario y sus scopes deciden a qué endpoints puede acceder.

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).

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