...
REST query | Body example | Response example | Response states | Description | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
/cdn/stream/access_list/add |
| 200 – OK 400 - Bad request 404 - Stream not found 500 – Internal Server Error | Add keys to stream ACL | |||||||||||||||
/cdn/stream/access_list/remove |
| 200 – OK 400 - Bad request 404 - Stream not found 500 – Internal Server Error | Remove keys from stream ACL | |||||||||||||||
/cdn/stream/access_list/delete |
| 200 – OK 400 - Bad request 404 - Stream not found 500 – Internal Server Error | Clean stream ACL | |||||||||||||||
/cdn/stream/access_list/print |
|
| 200 – OK 404 - ACL not found 500 – Internal Server Error | Show stream ACL |
...
Parameters
Name | Description | Example |
---|---|---|
name | Имя потока в CDN stream name | test |
keysСписок ключей доступа к потоку | Stream access keys list | ["key1","key2","key3"] |
Access to stream for subscribers
...
To play stream as HLS, access key should be passed in stream URL
Code Block | ||
---|---|---|
| ||
https://edge1.flashphoner.com:8445/test/test.m3u8?aclAuth=key1 |
Where
- edge1.flashphoner.com - server name
- aclAuth - parameter name as set in configuration
- test - stream name
When HLS ABR is used, access key should be passed in master playlist URL
Code Block | ||
---|---|---|
| ||
https://edge1.flashphoner.com:8445/test/index.m3u8?aclAuth=key1 |
In this case access key will be set to master playlist for every variant
Code Block | ||
---|---|---|
| ||
#EXTM3U #EXT-X-STREAM-INF:BANDWIDTH=1000000,RESOLUTION=1280x720,CODECS="avc1.42e01f,mp4a.40.2" ../test-720p/test-720p.m3u8?aclAuth=key1 #EXT-X-STREAM-INF:BANDWIDTH=1000000,RESOLUTION=852x480,CODECS="avc1.42e01f,mp4a.40.2" ../test-480p/test-480p.m3u8?aclAuth=key1 #EXT-X-STREAM-INF:BANDWIDTH=400000,RESOLUTION=426x240,CODECS="avc1.42e01f,mp4a.40.2" ../test-240p/test-240p.m3u8?aclAuth=key1 |
Passing a key to play stream via RTSP
Since build 5.2.1008 access key should be passed in stream URL to play stream as RTSP
Code Block | ||
---|---|---|
| ||
rtsp://edge1.flashphoner.com:5554/test?aclAuth=key1 |
Where
- edge1.flashphoner.com - server name
- aclAuth - parameter name as set in configuration
- test - stream name
Note that some players, VLC for example, pass a key in uppercase only. Use the following parameter to play stream via RTSP in such player
Code Block | ||
---|---|---|
| ||
case_sensitive_auth_match=false |
Passing the key using Android SDK to play stream via WebRTC
To play stream via WebRTC in Android application, access key should be passed to Connection.setCustom
method while connection establishing
Code Block | ||||
---|---|---|---|---|
| ||||
private Session session; private Connection connection; ... connection = new Connection(); connection.setCustom("aclAuth", "key1"); session.connect(connection); |
...