域名级别人数带宽统计接口

最近更新时间:2018-08-07 10:16:13

关于鉴权

  • 鉴权使用的签名算法是 HMAC-SHA1,密钥对是 Qiniu 账号的 AccessKey/SecretKey

域名级别实时播放人数带宽

  • 查询实时的域名级别播放人数以及播放带宽

    规格

    请求包:
GET /v2/hubs/<Hub>/stat/play/more?stream=<Stream>
Host: pili.qiniuapi.com
Authorization: <QiniuToken>
  • <Hub>: 直播空间名
  • <Stream>: 流名前缀匹配

返回包:

200   {
         "total": {
            "count": <Count>,
            "bandwidth": <Bandwidth>
        },
        "items": [
           {
              "streamTitle": <StreamTitle>,
              "domain": <Domain>,
              "type": <Type>,
              "count": <Count>,
              "bandwidth": <Bandwidth>
          }
        ]
      }
  • total.count: 总的播放人数
  • total.bandwidth: 总的播放带宽,单位 bps
  • items.streamTitle: 流名,形如 rtmp://xxxx/dctest/test中的test
  • items.domain: 播放域名
  • items.type: 播放类型,有三种播放类型: rtmp、hls、flv
  • items.count: 这路流的播放人数
  • items.bandwidth: 这路流的播放带宽,单位 bps

返回示例

{
    "total": {
        "count": 4,
        "bandwidth": 1131368
    },
    "items": [
        {
            "streamTitle": "stream-1522120761039222475",
            "domain": "xxxx",
            "type": "hls",
            "count": 1,
            "bandwidth": 115864
        },
        {
            "streamTitle": "stream-1522120761039222475",
            "domain": "xxxx",
            "type": "flv",
            "count": 1,
            "bandwidth": 200912
        },
        {
            "streamTitle": "stream-1522120761039222475",
            "domain": "xxxx",
            "type": "rtmp",
            "count": 1,
            "bandwidth": 242992
        },
        {
            "streamTitle": "stream-1522120761039222475",
            "domain": "xxxxx",
            "type": "rtmp",
            "count": 1,
            "bandwidth": 571600
        }
    ]
}

历史时间段内的域名级别播放人数带宽

  • 查询过去一段时间内的域名级别播放人数带宽
  • 返回的列表以 5 分钟为间隔

    规格

请求包:

GET /v2/hubs/<Hub>/stat/play/history/more?start=<Start>&end=<End>&stream=<Stream>&limit=<Limit>&marker=<Marker>
Host: pili.qiniuapi.com
Authorization: <QiniuToken>
  • <Hub>: 直播空间名
  • <Start>: 开始时间戳。不填,默认一小时前的时间戳
  • <End>: 结束时间戳。不填,默认当前时间戳
  • <Stream>: 流名前缀匹配
  • <Limit>: 返回的列表个数限制。不填,默认 10000
  • <Marker>: 如果上一次返回的结果超过了 limit,则会返回 marker 表示上一次读取到哪条记录。这一次请求带上 marker 后,继续从该 marker 后开始读取

返回包:

200   {
         "marker": "",
         "items": [
            {
               "time": <Time>,
               "values": [
                  {
                     "streamTitle": <StreamTitle>,
                     "domain": <Domain>,
                     "type": <Type>,
                     "count": <Count>,
                     "bandwidth": <Bandwidth>
                  },
               ]
            }
         ]
      }
  • marker: 若这次请求 items 个数超过了 limit,读取到哪条记录记为 marker
  • items.time: 这条记录的的时间戳,对齐到 5 分钟
  • items.streamTitle: 流名,形如 rtmp://xxxx/dctest/test中的test
  • items.domain: 播放域名
  • items.type: 播放类型,有三种播放类型: rtmp、hls、flv
  • items.count: 这路流的播放人数
  • items.bandwidth: 这路流的播放带宽,单位 bps

返回示例

{
  "marker": "",
  "items": [
    {
      "time": 1521771600,
      "values": [
        {
          "streamTitle": "stream-1521771326595869695",
          "domain": "xxxxx",
          "type": "flv",
          "count": 1,
          "bandwidth": 110588
        },
        {
          "streamTitle": "stream-1521771326186319627",
          "domain": "xxxx",
          "type": "hls",
          "count": 1,
          "bandwidth": 20936
        }
      ]
    }
  ]
}
以上内容是否对您有帮助?
  • Icon free helper
    Close