直播流禁推和解禁
更新時間 2023-11-28 18:35:46
最近更新時間: 2023-11-28 18:35:46
分享文章
接口功能介紹
通過該接口可實現對直播流的禁推和解禁。
使用說明
單個用戶一分鐘限制調用10000次,并發不超過100。
如果使用該接口,需要提前先聯系天翼云運營開啟域名禁推開關。
禁推場景下,最長支持封禁時長為14天。
接口詳情
請求方式:post
請求路徑:/live/stream/forbid-resume-stream
請求參數
| 參數名 | 類型 | 名稱 | 是否必填 | 說明 |
|---|---|---|---|---|
| action | int | 操作類型 | 是 | 2(解禁);3(禁推) |
| end_time | int | 任務結束時間戳 | 否 | 單位秒。若操作類型 = 2(解禁)時,不生效; 若操作類型 = 3(禁播)時,必填,為禁播結束時間。 |
| stream_list | list | 流對象列表 | 是 | |
| stream_list[*].domain | string | 域名名稱 | 是 | |
| stream_list[*].app_name | string | 發布點 | 是 | |
| stream_list[*].stream_name | string | 流名 | 是 |
響應參數
| 參數名 | 類型 | 說明 |
|---|---|---|
| code | int | 狀態碼。成功時為100000 |
| message | string | 描述信息。成功時為success |
示例
請求路徑://cdnapi-global.ctapi.daliqc.cn/live/stream/forbid-resume-stream
請求示例1:禁播
{
"action": 3,
"end_time": 1652168400,
"stream_list": [
{
"domain": "daliqc.cn",
"app_name": "xxxxx",
"stream_name": "xxxxx"
}
]
}
正常響應示例
{
"code": 100000,
"message": "success"
}
請求示例2:解禁
{
"action": 2,
"stream_list": [
{
"domain": "daliqc.cn",
"app_name": "xxxxx",
"stream_name": "xxxxx"
}
]
}
正常響應示例
{
"code": 100000,
"message": "success"
}
錯誤碼請參考:參數code和message含義