REST API

Загрузка видео, настройки плеера, статистика, лиды, продажи, тесты и вебхуки.

Базовый адрес: https://videostat.ru/api/v1. В каждом запросе Authorization: Bearer vs_…. Ключ создаётся в кабинете на тарифе «Про» и показывается целиком один раз. Этот текст собран из того же списка, что и сервер: расхождений с методами нет.

Методы

Метод	Путь	Назначение
`GET`	`/api/v1/me`	Тариф, лимиты и сколько уже занято
`GET`	`/api/v1/videos`	Список видео
`POST`	`/api/v1/videos/import`	Добавить видео по прямой ссылке на mp4, webm или m3u8
`POST`	`/api/v1/videos`	Загрузить видеофайл
`GET`	`/api/v1/videos/{id}`	Карточка видео: настройки, файлы, статус обработки
`PATCH`	`/api/v1/videos/{id}`	Название, папка, доступность страницы и настройки плеера
`DELETE`	`/api/v1/videos/{id}`	Удалить видео. Файл удаляется, когда не остаётся копий
`POST`	`/api/v1/videos/{id}/duplicate`	Копия: свой ключ, свои настройки и своя статистика, тот же файл
`POST`	`/api/v1/videos/{id}/retry`	Повторить обработку, если она завершилась ошибкой
`POST`	`/api/v1/videos/{id}/copy-settings`	Перенести настройки с другого своего видео
`POST`	`/api/v1/videos/{id}/assets`	Загрузить обложку, картинку или субтитры
`DELETE`	`/api/v1/videos/{id}/assets/{assetId}`	Удалить картинку или субтитры
`POST`	`/api/v1/videos/{id}/frame`	Сохранить кадр загруженного видео картинкой
`GET`	`/api/v1/videos/{id}/stats`	Статистика одного видео за период
`GET`	`/api/v1/videos/{id}/sessions`	Сессии просмотра
`GET`	`/api/v1/videos/{id}/sessions/{sid}`	Одна сессия: путь просмотра, события, продажи
`GET`	`/api/v1/stats`	Сводка по всем видео за период
`GET`	`/api/v1/stats/live`	Сколько человек смотрит прямо сейчас
`GET`	`/api/v1/compare`	Сравнить от 2 до 5 видео
`GET`	`/api/v1/folders`	Папки
`POST`	`/api/v1/folders`	Создать папку
`PATCH`	`/api/v1/folders/{id}`	Переименовать папку
`DELETE`	`/api/v1/folders/{id}`	Удалить папку. Видео остаются в «Без папки»
`GET`	`/api/v1/leads`	Лиды из форм плеера
`DELETE`	`/api/v1/leads/{id}`	Удалить лид
`GET`	`/api/v1/conversions`	Продажи
`POST`	`/api/v1/conversions`	Сообщить о продаже
`GET`	`/api/v1/tests`	Сплит-тесты
`POST`	`/api/v1/tests`	Создать сплит-тест
`GET`	`/api/v1/tests/{id}`	Один сплит-тест и его результаты
`PATCH`	`/api/v1/tests/{id}`	Название, статус или победитель
`DELETE`	`/api/v1/tests/{id}`	Удалить сплит-тест
`GET`	`/api/v1/webhooks`	Вебхуки и последние отправки
`POST`	`/api/v1/webhooks`	Подписка на события
`PATCH`	`/api/v1/webhooks/{id}`	Изменить вебхук
`DELETE`	`/api/v1/webhooks/{id}`	Удалить вебхук
`POST`	`/api/v1/webhooks/{id}/test`	Поставить тестовую отправку в очередь

Аккаунт

`GET /me`

Тариф, лимиты и сколько уже занято

curl -sS https://videostat.ru/api/v1/me \
  -H "Authorization: Bearer vs_ВАШ_КЛЮЧ"

Видео

`GET /videos`

Список видео

curl -sS https://videostat.ru/api/v1/videos \
  -H "Authorization: Bearer vs_ВАШ_КЛЮЧ"

`POST /videos/import`

Добавить видео по прямой ссылке на mp4, webm или m3u8 Файл остаётся по ссылке, на диск VideoStat не копируется.

curl -sS -X POST https://videostat.ru/api/v1/videos/import \
  -H "Authorization: Bearer vs_ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "...",
  "title": "...",
  "folderId": "..."
}'

`POST /videos`

Загрузить видеофайл Тело запроса — multipart, поле file. Исходник перекодируется, затем удаляется. В query можно передать folderId и title. Двоичную загрузку MCP не принимает: её делает этот метод.

curl -sS -X POST https://videostat.ru/api/v1/videos \
  -H "Authorization: Bearer vs_ВАШ_КЛЮЧ" \
  -F "file=@video.mp4"