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

Интерфейс для тех, кто встраивает загрузку в свои системы.

Авторизация

Ключ выдаётся в разделе «Настройки → Доступ к API» и передаётся заголовком:

GET /api/v2/videos HTTP/1.1
Host: api.streamhall.ru
Authorization: Bearer <ваш-ключ>

Загрузка файла

Загрузка идёт кусками по 8 МБ. Сначала открывается сессия:

POST /api/v2/uploads
{ "name": "planerka-2026-09-14.mp4", "size": 1843200000, "folder": "planerki" }

→ { "upload_id": "u_9f31c2", "chunk_size": 8388608 }

Затем куски отправляются по порядку, каждый со своим номером. После последнего куска сессия закрывается, и файл встаёт в очередь обработки.

Состояния обработки

СостояниеЧто значит
queuedФайл принят, ждёт очереди
processingИдёт перекодирование
readyГотов к просмотру во всех качествах
failedИсходник повреждён или формат не поддержан

Ограничения

Отдельные разделы: встраивание плеера, вебхуки, коды ошибок.