Документация API

API VideoManager построен по принципам REST. Все запросы выполняются по HTTPS к https://api.video-manager.xyz/api/v4, ответы возвращаются в формате JSON. Текущая версия API — v4; версия v3 поддерживается до 1 марта 2027 года.

Авторизация

Каждый запрос должен содержать API-ключ в заголовке Authorization. Ключи создаются в кабинете в разделе «Настройки → API». Тестовые ключи начинаются с vm_test_, боевые — с vm_live_.

Authorization: Bearer vm_live_••••••••••••••••

Загрузка видео

POST/api/v4/videos

Файлы до 2 ГБ можно загрузить одним запросом. Для файлов большего размера используйте загрузку частями через /api/v4/uploads.

Параметр	Тип	Описание
`file`	file	Видеофайл: MP4, MOV, MKV, WebM, AVI
`title`	string	Название ролика, до 255 символов
`folder_id`	string	Папка в библиотеке (необязательно)
`privacy`	string	`public`, `unlisted` или `signed`

Библиотека

GET/api/v4/videos?page=1&per_page=50

GET/api/v4/videos/{id}

DELETE/api/v4/videos/{id}

Статус видео меняется так: uploaded → processing → ready. При ошибке перекодирования статус становится failed, а в поле error появляется причина.

Плеер

Для встраивания используйте iframe со ссылкой из поля player_url. Плеер сам выбирает HLS или DASH и подстраивает качество под сеть зрителя. Статистика просмотра передаётся периодическими запросами к /api/v4/media и доступна в кабинете через 1–2 минуты.

<iframe src="https://media.video-manager.xyz/e/8Kq2mZ4tXw"
        allow="autoplay; fullscreen; picture-in-picture"
        width="960" height="540" frameborder="0"></iframe>

Вебхуки

Укажите URL в настройках проекта, и мы будем присылать POST-запросы о событиях. Каждый запрос подписан заголовком X-VM-Signature (HMAC-SHA256 от тела запроса).

Событие	Когда приходит
`video.ready`	Видео перекодировано и готово к показу
`video.failed`	Ошибка обработки файла
`session.completed`	Зритель закончил просмотр

Коды ошибок

Код	Значение
`400`	Некорректные параметры запроса
`401`	Не передан или неверен API-ключ
`403`	Нет доступа к ресурсу
`404`	Ресурс не найден
`413`	Файл слишком большой для обычной загрузки
`429`	Превышен лимит запросов

Лимиты

По умолчанию — 600 запросов в минуту на ключ. Текущий остаток возвращается в заголовках X-RateLimit-Remaining и X-RateLimit-Reset. Для повышения лимитов напишите на support@video-manager.xyz.