Streams
Add a stream
POST
https://api-v2.acrcloud.com/api/bm-cs-projects/:pid/streams
Path Parameters
Headers
Request Body
{
"data":
{
"stream_id":"s-AO****",
"uid":19,
"mcp_id":12417,
"stream_type":"Audio",
"name":"asdfasdf",
"state":"Running",
"code":0,
"stream_urls":[
"http://*******"
],
"current_url":"http://*******",
"region":"eu-west-1",
"user_defined":null,
"pitch_shift":0,
"check_pitch_shift":0,
"remark":"",
"created_at":"2020-06-07 07:42:16",
"updated_at":"2021-01-04 10:06:37",
"record_video":0,
"stream_rec_type":0,
"epg":"",
"config":{
"id":1,
"name":"non-realtime for music",
"uid":0,
"rec_length":10,
"interval":0,
"rec_timeout":5,
"monitor_timeout":25,
"noise":1,
"delay":1,
"record":{
"record":0,
"record_after":8,
"record_before":5
},
"created_at":"2018-05-31T03:20:53.000000Z"
},
"timemap":0,
"ucf":0
}
}
curl --location --request POST 'https://api-v2.acrcloud.com/api/bm-cs-projects/{your_project_id}/streams' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {your token}' \
--header 'Content-Type: application/json' \
--data-raw '{"stream_urls":["https://streamurl.com/1234"],"name":"test","config_id":1}'
import requests
url = "https://api-v2.acrcloud.com/api/bm-cs-projects/{your_project_id}/streams"
payload = {
"stream_urls": [
"https://streamurl.com/1234"
],
"name": "test",
"config_id": 1
}
headers = {
'Accept': 'application/json',
'Authorization': 'Bearer {your token}',
'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers=headers, json=payload)
print(response.text)
List streams in a project
GET
https://api-v2.acrcloud.com/api/bm-cs-projects/:pid/streams
Path Parameters
Query Parameters
Headers
{
"data": [
{
"stream_id": "s-At*****",
"uid": 19,
"mcp_id": 12417,
"stream_type": "Audio",
"name": "test",
"state": "Running",
"code": 0,
"stream_urls": [
"http://*******"
],
"current_url": "http://*******",
"region": "eu-west-1",
"user_defined": null,
"pitch_shift": 0,
"check_pitch_shift": 0,
"remark": "",
"created_at": "2019-09-19 09:59:17",
"updated_at": "2021-02-21 23:03:04",
"record_video": 0,
"stream_rec_type": 0,
"epg": "",
"config": {
"id": 15,
"name": "non-realtime and recording stream",
"uid": 72,
"rec_length": 10,
"interval": 0,
"rec_timeout": 5,
"monitor_timeout": 25,
"noise": 1,
"delay": 1,
"record": {
"record": 10,
"record_after": 0,
"record_before": 0
},
"created_at": "2018-07-26T03:19:15.000000Z"
},
"timemap": 1,
"ucf": 0
}
],
"links": {
"first": "https://api-v2.acrcloud.com/api/bm-cs-projects/12848/streams?page=1",
"last": "https://api-v2.acrcloud.com/api/bm-cs-projects/12848/streams?page=1",
"prev": null,
"next": null
},
"meta": {
"current_page": 1,
"from": 1,
"last_page": 1,
"path": "https://api-v2.acrcloud.com/api/bm-cs-projects/12848/streams",
"per_page": 50,
"to": 1,
"total": 1
}
}
curl --location --request GET 'https://api-v2.acrcloud.com/api/bm-cs-projects/13528/streams' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {your token}'
Update a stream
PUT
https://api-v2.acrcloud.com/api/bm-cs-projects/:pid/streams/:stream_id
Path Parameters
Headers
Request Body
{
"data":
{
"stream_id":"s-At*****",
"uid":19,
"mcp_id":12417,
"stream_type":"Audio",
"name":"test2",
"state":"Running",
"code":0,
"stream_urls":[
"https://*******"
],
"current_url":"https://*******",
"region":"eu-west-1",
"user_defined":null,
"pitch_shift":0,
"check_pitch_shift":0,
"remark":"",
"created_at":"2020-06-07 07:42:16",
"updated_at":"2021-01-04 10:06:37",
"record_video":0,
"stream_rec_type":0,
"epg":"",
"config":{
"id":1,
"name":"non-realtime for music",
"uid":0,
"rec_length":10,
"interval":0,
"rec_timeout":5,
"monitor_timeout":25,
"noise":1,
"delay":1,
"record":{
"record":0,
"record_after":8,
"record_before":5
},
"created_at":"2018-05-31T03:20:53.000000Z"
},
"timemap":0,
"ucf":0
}
}
curl --location --request PUT 'https://api-v2.acrcloud.com/api/bm-cs-projects/13528/streams/s-0xAHfNh' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {your token}' \
--header 'Content-Type: application/json' \
--data-raw '{"stream_urls":["https://streamurl.com/1234"],"name":"test2","config_id":1}'
Delete a stream
DELETE
https://api-v2.acrcloud.com/api/bm-cs-projects/:pid/streams/:stream_ids
Path Parameters
Headers
curl --location --request DELETE 'https://api-v2.acrcloud.com/api/bm-cs-projects/13528/streams/s-rHmM7rc' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {your token}'
Pause a stream
PUT
https://api-v2.acrcloud.com/api/bm-cs-projects/:pid/streams/:stream_ids/pause
Path Parameters
Headers
Restart a stream
PUT
https://api-v2.acrcloud.com/api/bm-cs-projects/:pid/streams/:stream_ids/restart
Path Parameters
Headers
Last updated