Miku 直播 > API 文档 > 直播流管理API >获取流信息

获取流信息

最近更新时间: 2025-12-25 11:38:20

描述

获取指定直播流的详细信息

接口信息

请求方法: GET
请求地址: <bucket>.mls.cn-east-1.qiniumiku.com
请求路径: /

请求参数

Query 参数

参数名称	类型	必填	示例值	描述
info	string	必须	无	固定流信息字段

Header 参数

参数名	位置	类型	必填	示例值	描述
Host	string	是	`<bucket>`.mls.cn-east-1.qiniumiku.com	请求的服务域名，Host 中的 `<bucket>` 是流所属的空间名称
Authorization	string	是	`<QiniuToken>`	管理凭证 QiniuToken，生成规则

请求示例

GET /<key>?info= HTTP/1.1
Host: <bucket>.mls.cn-east-1.qiniumiku.com
Authorization: <QiniuToken>

返回响应

响应状态码

请查阅: 这里

响应示例

{
    "bucketId": "myBucket",
    "region": "ap-1",
    "key": "myStream",
    "realKey": "real-key",
    "creationDate": "2019-01-01T00:00:00Z",
    "forbidden": false,
    "status": "online",
    "disablePublisherBattle": true,
    "enableBackupPublish": true,
    "lastStartAt": 1705457320,
    "domain": "qiniu.com",
    "localAddr": "127.0.0.1:22233",
    "remoteAddr": "127.0.0.1:23211"
}

响应参数

参数名称	类型	说明	是否必需
bucketId	string	空间名称	必需
region	string	区域，暂时只支持 `cn-east-1`	必需
key	string	流名称	必需
realKey	string	若开启主备流，则为主流的 key	必需
creationDate	string	创建时间，遵循 ISO 8601 格式	必需
forbidden	boolean	流是否被禁用	必需
status	string	流状态（online / offline）	必需
disablePublisherBattle	string	是否开启抢流	必需
enableBackupPublish	string	是否开启主备流	必需
isConverted	boolean	是否为转码流	必需
lastStartAt	string	最近一次推流时间	可选
domain	string	最近一次推流域名	可选
url	string	最近一次推流 URL	可选
localAddr	string	本地流媒体服务地址	可选
remoteAddr	string	推流客户端地址	可选
streamProfile	object	最近一次推流的流信息 (StreamProfile)	可选
├─ videoCodec	string	视频编码标准	必需
├─ videoProfile	string	视频编码配置	必需
├─ videoRate	string	视频码率 (kbps)	必需
├─ videoFps	string	视频编码帧率	必需
├─ videoResolution	string	视频分辨率（如 1280x720）	必需
├─ audioCodec	string	音频编码标准	必需
├─ audioProfile	string	音频编码配置	必需
├─ audioRate	string	音频码率 (kbps)	必需
├─ audioChannel	string	音频通道	必需
└─ audioSample	string	音频采样率	必需

以上内容是否对您有帮助？