Miku 快直播

    • Miku 快直播 > API 文档 > 直播流管理API >流历史推流记录

    流历史推流记录

    最近更新时间: 2026-06-29 13:47:54

    描述

    查询指定时间范围内的流历史推流记录，可按空间、推流域名、流名分页过滤。

    接口信息

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

    请求参数

    Query 参数

    参数名称 类型 必填 示例值 描述
    historyactivity string 必须 无 固定字段
    start string 必须 1707122646123 查询开始时间，支持毫秒时间戳、秒级时间戳、日期时间或日期格式
    end string 必须 1707126246123 查询结束时间，支持毫秒时间戳、秒级时间戳、日期时间或日期格式
    domain string 可选 publish.example.com 推流域名，domain 和 bucket 二选一
    bucket string 可选 sdk-live 空间名称，domain 和 bucket 二选一
    streamName string 可选 test-stream 流名
    limit integer 可选 10 每页返回条数
    offset integer 可选 0 分页偏移量
    orderBy string 可选 publish_time_desc 排序方式，可选值：publish_time_asc、publish_time_desc、stream_name_asc、stream_name_desc

    start / end 支持的格式包括：毫秒时间戳（如 1707122646123）、秒级时间戳（如 1588776655）、日期时间（如 20060102150405、2006-01-02-15-04-05、2006-01-02T15:04:05）以及日期（如 20060102、2006-01-02）。

    Header 参数

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

    请求示例

    GET /?historyactivity&start=1707122646123&end=1707126246123&bucket=sdk-live HTTP/1.1
Host: mls.cn-east-1.qiniumiku.com
Authorization: <QiniuToken>

    返回响应

    响应状态码

    响应示例

    {
    "items": [
        {
            "bucket": "sdk-live",
            "url": "rtmp://publish.example.com/live/test-stream",
            "domain": "publish.example.com",
            "streamName": "test-stream",
            "start": 1635162331,
            "end": 1635164952,
            "clientAddr": "127.0.0.1:19866",
            "serverAddr": "127.0.0.1:1935"
        },
        {
            "bucket": "sdk-live",
            "url": "rtmp://publish.example.com/live/test-stream",
            "domain": "publish.example.com",
            "streamName": "test-stream",
            "start": 1635161931,
            "end": 1635162330,
            "clientAddr": "127.0.0.1:10002",
            "serverAddr": "127.0.0.1:1935"
        }
    ],
    "connectId": "elUAAMiGo5hr1Y8X",
    "pageSize": 10,
    "pageNum": 2,
    "pageTotal": 12,
    "total": 120
}

    响应参数

    参数名称 类型 说明 是否必需
    items []object 直播流推流记录列表 必需
        ├─ bucket string 推流域名所属空间 必需
        ├─ url string 推流 URL 必需
        ├─ domain string 推流域名 必需
        ├─ streamName string 推流流名 必需
        ├─ start integer 推流开始时间，Unix 时间戳 必需
        ├─ end integer 推流结束时间，Unix 时间戳 必需
        ├─ clientAddr string 推流端地址 必需
        └─ serverAddr string 服务端地址 必需
    connectId string 连接 id 必需
    pageSize integer 每页大小 必需
    pageNum integer 分页页码 必需
    total integer 总个数 必需
    pageTotal integer 总页数 必需
    以上内容是否对您有帮助？