RestoreLiveStream 恢复直播流
恢复已禁用锁定的直播流,调用底层恢复接口解除推流阻断,清除流锁定标记,恢复推拉流能力。仅支持单条流操作,不可批量恢复,仅能操作当前账号名下的流。
请求信息
| 项目 |
内容 |
| 请求地址 |
http://openapi.chunyuyun.cn/RestoreLiveStream.ashx |
| 请求方式 |
POST Form表单 |
| 鉴权方式 |
HMAC-SHA256签名,签名规则参考【签名算法说明】章节 |
请求参数
| 参数名 |
是否必填 |
说明 |
| openapi_key |
是 |
开放密钥 AccessKey |
| Timestamp |
是 |
Unix秒级时间戳 |
| Nonce |
是 |
随机字符串,推荐GUID |
| Signature |
是 |
签名结果 |
| orderno |
是 |
流唯一编号(创建接口返回的orderno) |
请求示例
POST http://openapi.chunyuyun.cn/RestoreLiveStream.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 |
访问受限,请联系客服 |
⚠️ 注意事项:
1. 仅能恢复【DisabledLiveStream接口禁用】的流;已经回收的流为永久失效,不能恢复;
2. 恢复前置条件:流未过期、账号剩余流量大于0;
3. 恢复成功后 urllockState 置为0,锁定时间清空,流可以重新推流播放;
4. 仅能操作当前openapi_key归属的直播流。