GetLiveStreamDetail 查询单条流完整详情
根据流编号(orderno)查询单条直播流全部详情信息,包含推拉流地址、时间、实时带宽流量、在线人数、推流状态。仅支持查询当前账号下的单条流,不支持批量查询。
请求信息
| 项目 |
内容 |
| 请求地址 |
http://openapi.chunyuyun.cn/GetLiveStreamDetail.ashx |
| 请求方式 |
POST Form表单 |
| 鉴权方式 |
HMAC-SHA256签名,签名规则参考【签名算法说明】章节 |
请求参数
| 参数名 |
是否必填 |
说明 |
| openapi_key |
是 |
开放密钥 AccessKey |
| Timestamp |
是 |
Unix秒级时间戳 |
| Nonce |
是 |
随机字符串,推荐GUID |
| Signature |
是 |
签名结果 |
| orderno |
是 |
流唯一编号(创建接口返回的orderno) |
请求示例
POST http://openapi.chunyuyun.cn/GetLiveStreamDetail.ashx
Form参数:
openapi_key=AKxxxx
Timestamp=1769932800
Nonce=550e8400-e29b-41d4-a716-446655440000
orderno=YSCYY202611061630208888
Signature=【签名结果,参考签名文档】
返回参数说明
| 字段 |
说明 |
| orderno |
流唯一编号(订单号) |
| 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 |
流到期失效时间 |
| addtime |
记录入库时间 |
| bandwidth |
一分钟推流带宽(非实时) |
| traffic |
一分钟消耗流量(非实时) |
| onlineusers |
一分钟内并发数(非实时) |
| pushstate |
推流状态:1=正在推流,0=未推流 |
成功返回示例
{
"code": 0,
"msg": "success",
"data": [
{
"orderno": "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",
"addtime": "2026-11-06 16:30:20",
"bandwidth": "1.2Mbps",
"traffic": "5.6GB",
"onlineusers": 12,
"pushstate": 1
}
]
}
本接口专属错误码
| code |
说明 |
| 0 |
查询成功 |
| -1 |
直播流不存在(编号错误或者不属于当前账号) |
| -2 |
访问受限,请联系客服 |
⚠️ 注意事项:
1. 仅可查询归属当前openapi_key的流,不能查询其他账号的流;
2. onlineusers、bandwidth、traffic非实时数据,存在5-10分钟数据延迟。
3. 该接口为详情接口,适合单条流查看完整信息,批量列表查询请使用 GetOnlineLiveStreamList。