API for LIVE resource
Description
This section describes API methods for creating, deleting and configurations changing of your resources.
All the responses (including errors) return in JSON Format.
Attention!
- You can make not more than 20 API requests (POST, PUT, PATCH) every minute.
When the limit is reached, a response with the status code 200 will be received:
{"status": "error", "message": "Rate limit exceeded", "description": "Request is forbidden"}
- There is a limit of 100 resources. If you need more resources, please contact your personal manager or support.
Find below examples for monitoring and configuring of the options in connection with Live streaming service.
RTMP/RTSP-publish and SRT-publish
API description
Get links for publishing and distribution
To receive the full publication links, you have to combine live resource parameters, received via GET-request.
Link to publish the stream
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>
Examples of links for publication:
rtmp://a.r.cdn.beeline.net/livemaster/someid1_stream01?auth=MkE5MGtjbPljT52t491y6z14C srt://a.r.cdn.beeline.net:19998/?streamid=#!::r=livemastersrt/someid1_stream01,auth=IEVM5Vyew2nEjPcYZmaskikMN
Link for stream distribution
<dist_protocol>://<domain>/<application>/<master_stream>/playlist.m3u8
Example of link for stream distribution:
https://p0q2zwj4yih.a.trbcdn.net/livemaster/jws2w_test_resource.smil/playlist.m3u8
HLS-pull
API description
Get links for distribution
To receive the full streaming links, you have to combine live resource parameters, received via GET-request, and path to stream playlist.
<dist_protocol>://<cdn_domain|names>/<playlist_path>
Example of CDN-links:
https://wtx3l7rtrl6.a.trbcdn.net/stream/playlist.m3u8 https://test.cname.com/stream/playlist.m3u8
Get stream information
General information
This API provides an interface to get information about streams.
The API allows to get information about the status of the stream and the time when the stream appears on the server.
Warning!
There is a limit on the number of API calls: no more than 10 requests per minute.