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"}'
User Reports
Channels
Last updated 1 week ago
Broadcast Database Projects

postCreate a project

putUpdate a project

deleteDelete a project

getList the projects

postSet results callback URL

postSet state notification callback

post
Create a project

put
Update a project

delete
Delete a project

get
List the projects

post
Set results callback URL

post
Set state notification callback
