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

API для RTMP/RTSP-publish и SRT-publish ресурсов

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

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

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

Внимание!

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

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

Описание 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