接口功能介绍
查询指定域名的发布点、流名粒度配置。
接口详情
请求方式:POST
请求路径:/live/app-and-stream/query-app-and-stream
请求参数
参数 | 类型 | 名称 | 是否必填 | 说明 |
---|---|---|---|---|
product_code | string | 产品类型 | 是 | 支持:“005”(视频直播) |
domain | string | 域名 | 是 | 加速域名 |
响应参数
参数 | 类型 | 说明 | 下级对象 |
---|---|---|---|
code | int | 状态码,成功100000 | |
message | string | 信息描述,成功返回success,其他返回异常信息描述 | |
product_code | string | 产品类型,支持:“005”(视频直播) | |
domain | string | 加速域名 | |
apps_conf | list | 发布点配置 | apps_conf_single |
streams_conf | list | 流名配置 | streams_conf_single |
apps_conf_single
参数 | 类型 | 说明 | 下级对象 |
---|---|---|---|
id | string | 发布点配置ID | |
app_name | string | 发布点,一次只能提交1个频道名 支持精确匹配和模糊匹配(支持字母、数字、-、,但不能直接传“”),长度限制为128个字符 |
|
third_push | object | 转推任务,只支持配置一个转推任务,当前只支持绑定推流域名 | third_push |
time_shift | object | 时移任务,只支持配置一个时移任务,当前只支持绑定推流域名 | time_shift |
streams_conf_single
参数 | 类型 | 说明 | 下级对象 |
---|---|---|---|
id | string | 流名配置ID | |
app_name | string | 发布点 | |
stream_name | string | 流名称 | |
third_push | object | 转推任务,只支持配置一个转推任务,当前只支持绑定推流域名 | third_push |
time_shift | object | 时移任务,只支持配置一个时移任务,当前只支持绑定推流域名 | time_shift |
third_push
参数 | 类型 | 说明 | 下级对象 |
---|---|---|---|
switch | string | 转推开关,on(开启)、off(关闭) | |
push_list | list | 转推列表,开关开启时必填 | push_list_single |
push_list_single
参数 | 类型 | 说明 |
---|---|---|
origin | string | 转推目标ip或域名,支持ipv4、ipv6和域名 |
port | string | 转推目标端口,不填默认1935 |
host | string | 转推使用的请求头host |
time_shift
参数 | 类型 | 说明 |
---|---|---|
switch | string | 时移开关,on(开启)、off(关闭) |
max_playback_time | string | 时移任务回看时长,30s~30d(time格式,30s到30天); 默认一小时,支持的单位: s、m、 h、d |
module_id | string | 录制模板id,时移需要绑定的录制模板id |
示例
请求路径:https://cdnapi-global.ctapi.ctyun.cn/live/app-and-stream/query-app-and-stream
请求示例
{
"product_code": "005",
"domain": "ctyun.cn"
}
正常响应示例
{
"code": 100000,
"message": "success",
"product_code": "005",
"domain": "push.ctyun.cn",
"apps_conf": [
{
"id": "3d28337",
"app_name": "app-5"
},
{
"id": "34e11a897e2",
"app_name": "app3343",
"third_push": {
"switch": "on",
"push_list": [
{
"origin": "1.1.1.1",
"port": "11",
"host": "ctyun.cn1"
},
{
"origin": "2.1.1.1",
"port": "11",
"host": "ctyun.cn2"
}
]
},
"time_shift": {
"switch": "on",
"max_playback_time": "32s",
"module_id": "d656acd5"
}
}
],
"streams_conf": [
{
"id": "a3915a86b7c",
"app_name": "app-6",
"stream_name": "fff444"
},
{
"id": "e028077f8",
"app_name": "app-6",
"stream_name": "fffd",
"third_push": {
"switch": "on",
"push_list": [
{
"origin": "111.12.1.1",
"port": "11",
"host": "ctyun.cn3"
}
]
},
"time_shift": {
"switch": "on",
"max_playback_time": "32s",
"module_id": "d656eacd5"
}
}
]
}
错误码请参考:参数code和message含义