接口功能介绍
调用本接口可查询处于禁推状态的流信息。
使用说明
要查询禁推流,需要先有对直播流执行过禁推动作。
单个用户一分钟限制调用10000次,并发不超过100。
接口详情
请求方式:get
请求路径:/live/stream/query-forbid-stream
请求参数
参数名 | 类型 | 名称 | 是否必填 | 说明 |
---|---|---|---|---|
domain | string | 域名名称 | 是 | |
stream_name | string | 流名 | 否 | 不传或传空返回所有 |
app_name | string | 发布点 | 否 | 不传或传空返回所有 |
page_size | int | 分页大小 | 否 | 默认100,支持1~200 |
page | int | 页数 | 否 | 默认1 |
响应参数
参数名 | 类型 | 说明 |
---|---|---|
code | int | 状态码 |
message | string | 描述信息 |
total | int | 任务数量 |
page | int | 页数 |
page_size | int | 分页大小 |
result | list | 域名禁播解禁任务详情 |
result[*].domain | string | 域名 |
result[*].app_name | string | 发布点 |
result[*].stream_name | string | 流名 |
result[*].forbid_ts | int | 封禁开始时间戳 |
result[*].release_ts | int | 解禁开始时间戳 |
示例
请求路径:https://cdnapi-global.ctapi.ctyun.cn/live/stream/query-forbid-stream
请求示例
https://https://cdnapi-global.ctapi.ctyun.cn/live/stream/query-forbid-stream?domain=www.ctyun.cn&stream_name=stream_1&app_name=app_1&page_size=1&page=1
正确响应示例
{
"code": 100000,
"message": "success",
"total": 1,
"page": 1,
"page_size": 10,
"result": [
{
"domain": "ctyun.cn",
"app_name": "xxxxx",
"stream_name": "xxxxx",
"forbid_ts": 1644302237,
"release_ts": 1644302337
}
]
}
错误码请参考:参数code和message含义