Перейти к содержанию

API для pull ресурсов

Общая информация

В этом разделе описаны API-методы для создания, удаления и изменения конфигурации ресурсов, связанных с сервисом живых трансляций. Эти методы применяются в случае работы по схеме pull, когда поток cтягивается с внешнего источника.

Обратите внимание

На данный момент поддерживается стягивание потоков по протоколам RTMP, RTSP, SRT и HLS. Если требуется использование других протоколов, пожалуйста, свяжитесь с вашим персональным менеджером или службой поддержки.

Все ответы, включая ошибки, возвращаются в формате JSON.

Внимание!

  1. Установлено ограничение на количество обращений к API в размере не больше 20 обращений в минуту для POST, PUT и PATCH запросов. При достижении лимита будет получен ответ со статус-кодом 200: 
    {"status": "error", "message": "Rate limit exceeded", "description": "Request is forbidden"}
  2. В системе существует ограничение на ресурсы - до 100 шт. Если вам нужно больше ресурсов, то обратитесь к вашему персональному менеджеру или в саппорт.

RTMP/RTSP/SRT-pull

Описание API

Получение ссылок для раздачи

Для того, чтобы получить полные ссылки раздачи потоков, необходимо соединить параметры live-ресурса, полученные при GET-запросе.

<dist_protocol>://<domain>/<application>/<master_stream>/playlist.m3u8

Пример итоговой ссылки для раздачи: 

https://p0q2zwj4yih.a.trbcdn.net/livemaster/jws2w_test_resource.smil/playlist.m3u8

HLS-pull

Описание API

Получение ссылок для раздачи

Для того, чтобы получить полные ссылки раздачи потоков, необходимо соединить параметры live-ресурса, полученные при GET-запросе, и путь до плейлиста.

<dist_protocol>://<cdn_domain|names>/<playlist_path>

Примеры итоговых CDN-ссылок на плейлисты: 

https://wtx3l7rtrl6.a.trbcdn.net/stream/playlist.m3u8
https://test.cname.com/stream/playlist.m3u8