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. 本接口是强销毁接口,请谨慎调用。