Miku 快直播

    • Miku 快直播 > API 文档 > 数据统计API >查询直播上行流量

    查询直播上行流量

    最近更新时间: 2026-02-09 17:38:30

    描述

    查询直播上行流量

    查询一段时间内目标直播空间、域名、区域的上行流量，延迟5分钟左右
    带宽数据可以从返回的流量数据flow转化，计算方法为bandwidth（bps）=flow*8/时间粒度（例如时间粒度为 5 min，那么这里填写 300）

    接口信息

    • 请求方法: GET
    • 请求地址: miku-statd.qiniuapi.com
    • 请求路径: /statd/v1/traffic/stat/upflow

    请求参数

    Query 参数

    参数名称 类型 必填 示例值 描述
    begin string 必须 20060102 / 20060102150405 开始时间
    end string 可选 20060102 / 20060102150405 结束时间，超过当前时间，则以当前时间为准，时间范围为左闭右开区间
    g integer 必须 5min / hour / day / month 时间粒度
    group string 可选 group 按特定条件将返回数据分组，可取值为条件字段 hub、domain、streamName、area
    select string 必须 flow 固定字段
    $hub string 可选 hub 直播空间名，条件字段，用于筛选符合条件的数据
    $domain string 可选 domain 域名，条件字段，用于筛选符合条件的数据
    $streamName string 可选 streamName 流名，条件字段，用于筛选符合条件的数据
    $area string 可选 area 区域，可取值为 cn(中国大陆)、hk(香港)、tw(台湾)、apac(亚太)、am(美洲)、emea(欧洲/中东/非洲)，条件字段，用于筛选符合条件的数据

    Header 参数

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

    请求示例

    GET /statd/v1/traffic/stat/upflow?begin=begin&end=end&g=g&group=group&$hub=hub&$domain=domain&$streamName=streamName&$area=area&select=flow HTTP/1.1
Host: miku-statd.qiniuapi.com
Authorization: <QiniuToken>
Content-Type: application/json

    返回响应

    响应状态码

    响应示例

    [
    {
        "time": "2021-09-28T00:00:00+08:00",
        "values": {
            "flow": 4527162977
        }
    },
    {
        "time": "2021-09-29T00:00:00+08:00",
        "values": {
            "flow": 5407323840
        }
    }
]

    响应参数

    参数名称 类型 说明 是否必需
    time string 时间 必需
    values object 不使用分组查询时形式如：“values”:{“flow”:4527162977}，其中"flow"对应select项 使用分组查询时形式如：“values”:{“SD”:{“flow”:4527162977}}，其中"SD"对应group项，"flow"对应select项 必需
    以上内容是否对您有帮助？