直播云

  • 直播云 > 常见问题 > 服务端知识库 >域名级别人数带宽统计接口

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

    最近更新时间: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
            }
          ]
        }
      ]
    }
    
    以上内容是否对您有帮助?
  • Qvm free helper
    Close