Аутентификация

Публичный API VibeVO использует API-ключи. Каждый запрос должен содержать действующий ключ в заголовке. Ключ определяет владельца, а его скоупы — какие эндпоинты доступны.

Формат ключа

Ключ выглядит так:

vibevo_live_{prefix}.{secret}

prefix — короткий публичный идентификатор ключа (виден в кабинете, помогает узнать ключ в списке).
secret — секретная часть. Показывается только один раз при создании и больше нигде не отображается.

Секрет показывается один раз

Скопируйте полный ключ сразу после создания и храните его в защищённом месте (менеджер секретов, переменные окружения). Если ключ утерян — создайте новый и удалите старый.

Как создать ключ

Ключи создаются в кабинете на странице Настройки — внизу есть блок «API-ключи». При создании ключа вы:

задаёте название (чтобы отличать ключи между собой);
выбираете скоупы — набор разрешений для этого ключа;
при необходимости задаёте срок действия (expiry);
копируете полный ключ из окна — он показывается один раз.

Передача ключа в запросе

Поддерживаются два равнозначных заголовка — используйте любой:

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

Скоупы

Всего два права — по-отдельности функции не выбираются:

read — любой GET (кампании, офферы, аналитика, посты, креаторы, кошелёк, трекинг-ссылки, фабрики). Ключ получает read всегда.
write — любая запись (фабрики контента, подача видео).

Ошибки авторизации

401 Unauthorized — ключ отсутствует, недействителен, истёк или отозван.
403 Forbidden — ключ валиден, но у него нет скоупа, требуемого этим эндпоинтом.

Формат тела ошибки описан в справочнике эндпоинтов.

Обзор API

Справочник эндпоинтов

Была ли эта статья полезна?

Обновлено: 11 июля 2026