Miku 直播

    • Miku 直播 > API 文档 > 直播流管理API >列举流列表

    列举流列表

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

    描述

    列举指定直播空间中的活跃流信息，如果传递了start & end, 则查询在 start 和 end 之间有推流数据的流信息，
    没有传 start & end， 则查询所有推流数据的流信息

    接口信息

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

    请求参数

    Query 参数

    参数名称 类型 必填 示例值 描述
    streamlist string 必须 无 固定字段
    prefix string 可选 - 流名前缀
    offset string 可选 1 游标，表示从该位置开始返回 默认为 0
    limit string 可选 10 返回个数 limit 默认为 10, 若 <=0 默认最大返回 500 条数据
    domain string 可选 qiniu.com 推流域名, bucketId domain 必须二传一
    start integer 可选 1705376688 最近一次推流开始时间
    end integer 可选 1705376688 最近一次推流结束时间
    bucketId string 可选 - bucketId, bucketId domain 必须二传一
    isForbid boolean 可选 - 是否只查询被封禁的流

    Header 参数

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

    请求示例

    GET /?streamlist&prefix&offset=1&limit=10&liveonly=true&domain=qiniu.com&start&end&bucketId&isForbid HTTP/1.1
Host: mls.cn-east-1.qiniumiku.com
Authorization: <QiniuToken>

    返回响应

    响应状态码

    响应示例

    {
    "items": [
        {
            "key": "stream1",
            "bucket": "cdntest",
            "creationDate": 1705376688,
            "status": "online",
            "lastStartAt": 1701708771
        }
    ],
    "total": 29
}

    响应参数

    参数名称 类型 说明 是否必需
    items []object 流列表数据 必需
        ├─ key string 流名称 必需
        ├─ forbidden boolean 是否禁播流 必需
        ├─ creationDate string 创建时间（时间类型） 必需
        ├─ status string 状态（online / offline） 必需
        ├─ lastStartAt integer 最近一次推流时间（Unix 毫秒时间戳） 必需
        └─ publishUrl string 推流 URL 必需
    total integer 总数 必需
    totalPage string 总页数 必需
    pageIndex string 分页码 必需
    pageSize string 分页大小 必需
    以上内容是否对您有帮助？