DisabledLiveStream 禁用直播流
禁用指定直播流,调用底层禁流接口阻断推流,同时标记流锁定状态,可通过恢复接口解除锁定。仅支持单条流操作,不可批量禁用,仅能操作当前账号名下的流。
请求信息
| 项目 |
内容 |
| 请求地址 |
http://openapi.chunyuyun.cn/DisabledLiveStream.ashx |
| 请求方式 |
POST Form表单 |
| 鉴权方式 |
HMAC-SHA256签名,签名规则参考【签名算法说明】章节 |
请求参数
| 参数名 |
是否必填 |
说明 |
| openapi_key |
是 |
开放密钥 AccessKey |
| Timestamp |
是 |
Unix秒级时间戳 |
| Nonce |
是 |
随机字符串,推荐GUID |
| Signature |
是 |
签名结果 |
| orderno |
是 |
流唯一编号(创建接口返回的orderno) |
请求示例
POST http://openapi.chunyuyun.cn/DisabledLiveStream.ashx
Form参数:
openapi_key=AKxxxx
Timestamp=1769932800
Nonce=550e8400-e29b-41d4-a716-446655440000
orderno=YSCYY202611061630208888
Signature=【签名结果,参考签名文档】
返回参数说明
| 字段 |
说明 |
| code |
返回状态码 |
| msg |
状态描述信息 |
成功返回示例
{
"code": 0,
"msg": "success"
}
本接口专属错误码
| code |
说明 |
| 0 |
禁用成功,流已锁定,推流已阻断 |
| -1 |
底层禁流接口执行成功,但数据库锁定状态更新失败 |
| -2 |
调用底层禁流接口失败,禁用动作失败 |
| -3 |
订单已过期,无法禁用 |
| -4 |
订单无效:编号不存在或者不属于当前账号 |
| -5 |
访问受限,请联系客服 |
⚠️ 注意事项:
1. 禁用≠回收,禁用属于临时锁定,支持调用恢复接口解锁继续推流;回收是永久强制过期,不可恢复;
2. 流必须处于未过期状态才允许禁用;
3. 禁用后该流无法推流播放,解锁后可恢复使用;
4. 仅能操作当前openapi_key归属的直播流。