API v4

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

API принимает и возвращает JSON. Все запросы выполняются по HTTPS.

Авторизация

Ключ API передаётся в заголовке Authorization. Ключи создаются в личном кабинете и могут быть ограничены по правам.

Authorization: Bearer <API_KEY>

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

Создайте объект видео, затем загрузите файл по полученной ссылке. Большие файлы можно загружать частями.

POST /api/v4/videos
{
  "title": "Урок 1. Введение",
  "folder_id": "f_2041"
}

201 Created
{
  "id": "v_8d1c27e5",
  "upload_url": "https://upload.hexlink.ru/v4/u/v_8d1c27e5",
  "status": "waiting_upload"
}

Статус обработки

GET /api/v4/videos/v_8d1c27e5

{
  "id": "v_8d1c27e5",
  "status": "ready",
  "duration": 425.3,
  "renditions": ["240p", "360p", "480p", "720p", "1080p"]
}

Возможные статусы: waiting_upload, processing, ready, failed.

Воспроизведение

Для готового видео доступен мастер-плейлист HLS. Плеер сам загружает плейлисты качеств и сегменты.

https://<ваш-домен>/hls/v4/vod/v_8d1c27e5/master.m3u8

Код встраивания плеера:

<iframe src="https://<ваш-домен>/embed/v_8d1c27e5"
        allow="autoplay; fullscreen" allowfullscreen></iframe>

Вебхуки

Укажите URL в настройках проекта — мы отправим POST-запрос при смене статуса видео. Тело подписано HMAC-SHA256, подпись в заголовке X-Hexlink-Signature.

Ограничения

Не более 20 запросов в секунду на ключ.
Размер исходного файла — до 50 ГБ.
Ссылки на поток с подписью действуют до 24 часов.