RecycleLiveStreamUrl.ashx 回收直播流地址

回收指定直播流地址,回收操作会执行禁流动作并强制将流过期,流地址回收后无法继续推流与播放。本接口仅支持单条流回收,不支持批量操作。
请求信息
项目 内容
请求地址 http://openapi.chunyuyun.cn/RecycleLiveStreamUrl.ashx
请求方式 POST Form表单
鉴权方式 HMAC-SHA256签名,签名规则参考【签名算法说明】章节
请求参数
参数名 是否必填 说明
openapi_key 是 开放密钥 AccessKey
Timestamp 是 Unix秒级时间戳
Nonce 是 随机字符串,推荐GUID
Signature 是 签名结果
orderno 是 流唯一编号(创建接口返回的orderno)
请求示例
POST http://openapi.chunyuyun.cn/RecycleLiveStreamUrl.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 订单流已经过期,无需回收
-6 订单无效:orderno不存在或者不属于当前openapi_key账号
-7 服务内部异常
⚠️ 注意事项:
1. 回收成功后流地址直接强制过期,该流所有推拉链接全部失效,无法恢复;
2. 流正在推流(pushstate=1)时不允许回收,需要先停止推流;
3. 仅能回收属于当前openapi_key下的流,不可操作其他账号的流;
4. 本接口是强销毁接口,请谨慎调用。