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

API для LIVE-ресурса

Описание

В этом разделе описаны методы API для создания, удаления и изменения конфигурации ваших ресурсов.

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

Внимание!

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

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

RTMP/RTSP-publish и SRT-publish

Описание API

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

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

Ссылка для публикации потока

RTMP/RTSP-publish: 

<pub_protocol>://<primary|backup>/<application>/<stream_name>?auth=<password>

SRT-publish: 

<pub_protocol>://<primary|backup>:19998/?streamid=#!::r=<application>/<stream_name>,auth=<password>

Примеры итоговых ссылок для публикации: 

rtmp://a.r.cdnvideo.net/livemaster/someid1_stream01?auth=MkE5MGtjbPljT52t491y6z14C
srt://a.r.cdnvideo.net:19998/?streamid=#!::r=livemastersrt/someid1_stream01,auth=IEVM5Vyew2nEjPcYZmaskikMN

Ссылка для раздачи потока

<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

Получение информации о потоках

Общие сведения

Данный API предоставляет интерфейс для получения информации о потоках.

На данном этапе API позволяет получать информацию о статусе потока и времени появления потока на сервере.

Внимание!

Установлено ограничение на количество обращений к API: не больше 10 обращений в минуту.

Описание API