Broadcast Database Projects

post
Create a project

https://api-v2.acrcloud.com/api/bm-bd-projects
Request
Response
Request
Headers
Authentication
required
string
Bearer token
Accept
required
string
application/json
Content-Type
required
string
application/json
Body Parameters
region
optional
string
eu-west-1,us-west-2,ap-southeast-1
name
optional
string
The project name
buckets
optional
array
Bucket ids array
Response
200: OK
Cake successfully retrieved.
{
"data": {
"id": 12345,
"name": "test",
"uid": 2,
"region": "eu-west-1",
"bucket_ids": "14661",
"updated_at": "2021-02-22 03:38:28",
"created_at": "2021-02-22 03:38:27",
"access_key": "**********",
"buckets": [
{
"id": 14661,
"uid": 2,
"name": "test",
"type": "File",
"node": "10.12.12.236-850",
"state": 1,
"region": "eu-west-1",
"metadata_template": "isrc, artist, album",
"labels": [
"Music"
],
"net_type": 1,
"created_at": "2020-07-06 11:25:08",
"updated_at": "2020-07-06 11:25:08",
"num": 0,
"size": 0,
"access_permission": "private"
}
],
"config": {
"record": {
},
"ucf": {
},
"callback_result": {
"enabled": 0,
"type_name": "diy",
"diy_url": "",
"diy_send_type": 2,
"diy_send_noresult": 0,
"diy_result_type": -1,
"r3d_source": "",
"r3d_url": "",
"r3d_key1": "",
"r3d_key2": "",
"r3d_result_type": "0"
},
"callback_state": {
"enabled": 0,
"url": "",
"send_type": 2
},
"email_state": {
"email": "",
"type": 2
},
"access_permission": {
"add_tv": 0,
"edit_url": 0,
"can_modify": 1
}
},
"monitoring_num": 0,
"type": "BM-Database",
"status_check": 2
}
}
Curl
Curl
curl --location --request POST 'https://api-v2.acrcloud.com/api/bm-bd-projects' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {your token}' \
--header 'Content-Type: application/json' \
--data-raw '{"region": "eu-west-1", "name": "test1", "buckets": [14661]}'

put
Update a project

https://api-v2.acrcloud.com/api/bm-bd-projects/:id
Request
Response
Request
Path Parameters
id
required
number
The project id
Headers
Authentication
required
string
Bearer token
Accept
required
string
application/json
Content-Type
required
string
application/json
Body Parameters
name
optional
string
The project name
buckets
optional
array
Response
200: OK
{
"data": {
"id": 12345,
"name": "test2",
"uid": 2,
"region": "eu-west-1",
"bucket_ids": "23,14661",
"updated_at": "2021-02-22 03:44:08",
"created_at": "2021-02-22 03:38:27",
"access_key": "**************",
"buckets": [
{
"id": 23,
"uid": 0,
"name": "ACRCloud Music",
"type": "ACRCloudFile",
"node": "52.50.121.26-8870",
"state": 1,
"region": "global",
"metadata_template": "",
"labels": [
"Music"
],
"net_type": 0,
"created_at": "2015-05-05 04:22:19",
"updated_at": "2020-05-13 19:28:15",
"num": 72002117,
"size": 397184,
"access_permission": "private"
},
{
"id": 14661,
"uid": 72,
"name": "test",
"type": "File",
"node": "10.12.12.236-850",
"state": 1,
"region": "eu-west-1",
"metadata_template": "isrc, artist, album",
"labels": [
"Music"
],
"net_type": 1,
"created_at": "2020-07-06 11:25:08",
"updated_at": "2020-07-06 11:25:08",
"num": 0,
"size": 0,
"access_permission": "private"
}
],
"config": {
"record": {
},
"ucf": {
},
"callback_result": {
"enabled": 0,
"type_name": "diy",
"diy_url": "",
"diy_send_type": 2,
"diy_send_noresult": 0,
"diy_result_type": -1,
"r3d_source": "",
"r3d_url": "",
"r3d_key1": "",
"r3d_key2": "",
"r3d_result_type": "0"
},
"callback_state": {
"enabled": 0,
"url": "",
"send_type": 2
},
"email_state": {
"email": "",
"type": 2
},
"access_permission": {
"add_tv": 0,
"edit_url": 0,
"can_modify": 1
}
},
"monitoring_num": 0,
"type": "BM-Database",
"status_check": 2
}
}
Curl
Curl
curl --location --request PUT 'https://api-v2.acrcloud.com/api/bm-bd-projects/12345' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {your token}' \
--header 'Content-Type: application/json' \
--data-raw '{"region": "eu-west-1", "name": "test2", "buckets": [14661, 23]}'

delete
Delete a project

https://api-v2.acrcloud.com/api/bm-bd-projects/:id
Request
Response
Request
Path Parameters
id
required
string
The project id
Headers
Authentication
required
string
Bearer token
Accept
required
string
application/json
Response
204: No Content
Curl
Curl
curl --location --request DELETE 'https://api-v2.acrcloud.com/api/bm-bd-projects/12345' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {your token}' \

get
List the projects

https://api-v2.acrcloud.com/api/bm-bd-projects
Request
Response
Request
Headers
Authentication
required
string
Bearer token
Accept
required
string
application/json
Query Parameters
region
optional
string
Response
200: OK
{
"data": [
{
"id": 12345,
"name": "test",
"uid": 2,
"region": "eu-west-1",
"bucket_ids": "23",
"updated_at": "2020-07-27 03:35:51",
"created_at": "2020-06-16 10:09:35",
"access_key": "***************",
"buckets": [
{
"id": 23,
"uid": 0,
"name": "ACRCloud Music",
"type": "ACRCloudFile",
"node": "52.50.121.26-8870",
"state": 1,
"region": "global",
"metadata_template": "",
"labels": [
"Music"
],
"net_type": 0,
"created_at": "2015-05-05 04:22:19",
"updated_at": "2020-05-13 19:28:15",
"num": 72002117,
"size": 397184,
"access_permission": "private"
}
],
"config": {
"record": {
},
"ucf": {
},
"callback_result": {
"enabled": 0,
"type_name": "diy",
"diy_url": "",
"diy_send_type": 2,
"diy_send_noresult": 0,
"diy_result_type": 1,
"r3d_source": "",
"r3d_url": "",
"r3d_key1": "",
"r3d_key2": "",
"r3d_result_type": "0"
},
"callback_state": {
"enabled": 0,
"url": "",
"send_type": 2
},
"email_state": {
"email": "",
"type": 2
},
"access_permission": {
"add_tv": 0,
"edit_url": 0,
"can_modify": 1
}
},
"monitoring_num": 1,
"type": "BM-Database",
"status_check": 2
}
],
"links": {
"first": "https://api-v2.acrcloud.com/api/bm-bd-projects?page=1",
"last": "https://api-v2.acrcloud.com/api/bm-bd-projects?page=1",
"prev": null,
"next": null
},
"meta": {
"current_page": 1,
"from": 1,
"last_page": 1,
"path": "https://api-v2.acrcloud.com/api/bm-bd-projects",
"per_page": "20",
"to": 2,
"total": 2
}
}
CURL
CURL
curl --location --request GET 'https://api-v2.acrcloud.com/api/bm-bd-projects?region=eu-west-1&page=1&per_page=20' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {your token}' \

post
Set results callback URL

https://api-v2.acrcloud.com/api/bm-bd-projects/:id/result-callback
Request
Response
Request
Path Parameters
id
required
string
the project id
Headers
Authentication
required
string
Bearer token
Accept
required
string
application/json
Content-Type
required
string
application/json
Body Parameters
result_callback_url
optional
string
set the callback url
result_callback_send_noresult
optional
number
result_callback_send_noresult: whether inform you when no content detected. 0 or 1
result_callback_
optional
string
result_callback_result_type: 0: RealTime 1: Delay
Response
200: OK
{
"data":{
"id":12345,
"name":"monitor_test",
"uid":2,
"region":"eu-west-1",
"bucket_ids":"23",
"updated_at":"2019-11-18 03:34:09",
"created_at":"2019-03-19 03:15:48",
"access_key":"**************",
"buckets":[
{
"id":23,
"uid":0,
"name":"ACRCloud Music",
"type":"ACRCloudFile",
"node":"52.50.121.26-8870",
"state":1,
"region":"global",
"metadata_template":"",
"labels":[
"Music"
],
"net_type":0,
"created_at":"2015-05-05 04:22:19",
"updated_at":"2020-05-13 19:28:15",
"num":72002117,
"size":397184,
"access_permission":"private"
}
],
"config":{
"record":{
},
"ucf":{
},
"callback_result":{
"enabled":1,
"type_name":"diy",
"diy_url":"http://test.acrcloud.com",
"diy_send_type":2,
"diy_send_noresult":0,
"diy_result_type":0,
"r3d_source":"",
"r3d_url":"",
"r3d_key1":"",
"r3d_key2":"",
"r3d_result_type":"0"
},
"callback_state":{
"enabled":0,
"url":"",
"send_type":2
},
"email_state":{
"email":"",
"type":2
},
"access_permission":{
"add_tv":0,
"edit_url":1,
"can_modify":1
}
},
"monitoring_num":4,
"type":"BM-Database",
"status_check":2
}
}
Curl
Curl
curl --location --request POST 'https://api-v2.acrcloud.com/api/bm-bd-projects/12345/result-callback?type=diy' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your token}' \
--data-raw '{"result_callback_url": "http://*****", "result_callback_send_noresult": false, "result_callback_send_type": "2", "result_callback_result_type": "1"}'

post
Set state notification callback

https://api-v2.acrcloud.com/api/bm-bd-projects/:id/state-notification
Request
Response
Request
Path Parameters
id
required
number
The project id
Headers
Authentication
required
string
Bearer token
Accept
required
string
application/json
Content-Type
required
string
application/json
Body Parameters
state_callback_url
optional
string
If the streams state change, we will post a result to this url you set.
Response
200: OK
{
"data":{
"id":12345,
"name":"monitor_test",
"uid":2,
"region":"eu-west-1",
"bucket_ids":"23",
"updated_at":"2019-11-18 03:34:09",
"created_at":"2019-03-19 03:15:48",
"access_key":"***************",
"buckets":[
{
"id":23,
"uid":0,
"name":"ACRCloud Music",
"type":"ACRCloudFile",
"node":"52.50.121.26-8870",
"state":1,
"region":"global",
"metadata_template":"",
"labels":[
"Music"
],
"net_type":0,
"created_at":"2015-05-05 04:22:19",
"updated_at":"2020-05-13 19:28:15",
"num":72002117,
"size":397184,
"access_permission":"private"
}
],
"config":{
"record":{
},
"ucf":{
},
"callback_result":{
"enabled":0,
"type_name":"diy",
"diy_url":"",
"diy_send_type":2,
"diy_send_noresult":0,
"diy_result_type":0,
"r3d_source":"",
"r3d_url":"",
"r3d_key1":"",
"r3d_key2":"",
"r3d_result_type":"0"
},
"callback_state":{
"enabled":1,
"url":"http://test.acrcloud.com",
"send_type":2
},
"email_state":{
"email":"",
"type":2
},
"access_permission":{
"add_tv":0,
"edit_url":1,
"can_modify":1
}
},
"monitoring_num":4,
"type":"BM-Database",
"status_check":2
}
}
Curl
Curl
curl --location --request POST 'https://api-v2.acrcloud.com/api/bm-bd-projects/12345/state-notification' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your token}' \
--data-raw '{"state_callback_url": "http://www.xxxx.com/state_callback", "state_callback_type": "2"}'