GetLiveStreamList 获取直播流地址列表
获取当前账号下,所有未过期的直播流列表,按创建时间倒序返回。本接口仅查询当前账号自有流,不支持批量跨账号查询。
请求信息
| 项目 |
内容 |
| 请求地址 |
http://openapi.chunyuyun.cn/GetLiveStreamList.ashx |
| 请求方式 |
POST Form表单 |
| 鉴权方式 |
HMAC-SHA256签名,签名规则参考【签名算法说明】章节 |
请求参数
| 参数名 |
是否必填 |
说明 |
| openapi_key |
是 |
开放密钥 AccessKey |
| Timestamp |
是 |
Unix秒级时间戳 |
| Nonce |
是 |
随机字符串,推荐GUID |
| Signature |
是 |
签名结果 |
请求示例
POST http://openapi.chunyuyun.cn/GetLiveStreamList.ashx
Form参数:
openapi_key=AKxxxx
Timestamp=1769932800
Nonce=550e8400-e29b-41d4-a716-446655440000
Signature=【签名结果,参考签名文档】
返回参数说明
| 字段 |
说明 |
| ordernum |
流唯一编号(订单号),用于后续禁用、回收、查询详情接口 |
| livecenter |
直播中心名称 |
| billingmethod |
计费方式 |
| notes |
流备注/标题 |
| push_rtmp_url |
RTMP推流地址 |
| push_srt_url |
SRT推流地址 |
| pull_rtmp_url |
RTMP播放地址 |
| pull_srt_url |
SRT播放地址 |
| pull_flv_url |
FLV格式播放地址 |
| pull_m3u8_url |
M3U8格式播放地址 |
| pull_artc_url |
ARTC低延迟播放地址 |
| urlstime |
流创建时间 |
| urletime |
流到期失效时间 |
成功返回示例
{
"code": 0,
"msg": "success",
"data": [
{
"ordernum": "YSCYY202611061630208888",
"livecenter": "北京(标准)",
"billingmethod": "流量计费",
"notes": "直播间测试标题",
"pushurlRTMP": "rtmp://xxx/live/xxxx",
"pushurlSRT": "srt://xxx:9000?streamid=xxxx",
"playurlRTMP": "rtmp://xxx/live/xxxx",
"playurlSRT": "srt://xxx:9000?streamid=xxxx",
"playurlFLV": "http://xxx/live/xxxx.flv",
"playurlM3U8": "http://xxx/live/xxxx.m3u8",
"playurlARTC": "artc://xxx/live/xxxx",
"urlstime": "2026-11-06 16:30:20",
"urletime": "2026-12-06 16:30:20"
},
{
"ordernum": "YSCYY202611061630208888",
"livecenter": "北京(标准)",
"billingmethod": "流量计费",
"notes": "直播间测试标题",
"pushurlRTMP": "rtmp://xxx/live/xxxx",
"pushurlSRT": "srt://xxx:9000?streamid=xxxx",
"playurlRTMP": "rtmp://xxx/live/xxxx",
"playurlSRT": "srt://xxx:9000?streamid=xxxx",
"playurlFLV": "http://xxx/live/xxxx.flv",
"playurlM3U8": "http://xxx/live/xxxx.m3u8",
"playurlARTC": "artc://xxx/live/xxxx",
"urlstime": "2026-11-06 16:30:20",
"urletime": "2026-12-06 16:30:20"
}
]
}
本接口专属错误码
| code |
说明 |
| 0 |
查询成功,无符合条件流时data为空数组[] |
| -1 |
访问受限,请联系客服 |
⚠️ 注意事项:
1. 查询筛选条件:流未过期;已停止推流、已回收、已过期的流不会在列表内返回;
2. 列表按流创建时间 urlstime 倒序排列,最新创建的流排在最前面;
3. 无符合条件数据时,data 返回空数组,code仍然为0,属于正常返回。