视频直播

产品文档

视频直播

帮助中心 > OpenAPI & SDK > 视频直播 > 查询地域分组统计数据

describeLiveStatisticGroupByArea

描述

查询地域分组统计数据

请求方式

GET

请求地址

https://live.jdcloud-api.com/v1/describeLiveStatisticGroupByArea

请求参数

名称 类型 是否必需 默认值 描述
domainName String True 播放域名
appName String True 应用名称
streamName String True 流名称
ispName String False 运营商
locationName String False 地域,如beijing,shanghai。多个用逗号分隔
period String False 查询周期,当前取值范围:“oneMin,fiveMin,halfHour,hour,twoHour,sixHour,day,followTime”,分别表示1min,5min,半小时,1小时,2小时,6小时,1天,跟随时间。默认为空,表示fiveMin。当传入followTime时,表示按Endtime-StartTime的周期,只返回一个点
startTime String True 起始时间
- UTC时间
格式:yyyy-MM-dd'T'HH:mm:ss'Z'
示例:2018-10-21T10:00:00Z
endTime String False 结束时间:
- UTC时间
格式:yyyy-MM-dd'T'HH:mm:ss'Z'
示例:2018-10-21T10:00:00Z
- 为空,默认为当前时间,查询时间跨度不超过1天

返回参数

名称 类型 描述
result Result
requestId String requestId

Result

名称 类型 描述
dataList LiveStatisticGroupByAreaResult[ ]

LiveStatisticGroupByAreaResult

名称 类型 描述
startTime String 起始时间点,UTC时间,格式:yyyy-MM-dd'T'HH:mm:ss'Z'
endTime String 结束时间点,UTC时间,格式:yyyy-MM-dd'T'HH:mm:ss'Z'
data LiveStatisticGroupByAreaResultData[ ]

LiveStatisticGroupByAreaResultData

名称 类型 描述
area String 地域
playerCount Long 在线人数
bandwidth Long 带宽,单位:bps
maxBandwidthtime Long 带宽峰值时间点,单位:秒
flow Long 流量,单位:Byte

返回码

返回码 描述
200 OK
400 Invalid parameter
401 Authentication failed
404 Not found
500 Internal server error
503 Service unavailable

请求示例

GET

https://live.jdcloud-api.com/v1/describeLiveStatisticGroupByArea?domainName=yourdomain&appName=yourapp&streamName=yourstream&startTime=2018-10-21T10:00:00Z&&endTime=2018-10-22T10:00:00Z

返回示例

{
    "requestId": "bgvmivir54gddpgi764se9f4kfr7ge41", 
    "result": {
        "dataList": [
            {
                "data": [ ], 
                "endTime": "2019-06-14T08:50:00Z", 
                "startTime": "2019-06-14T08:45:00Z"
            }, 
            {
                "data": [
                    {
                        "area": "beijing", 
                        "bandwidth": 808894, 
                        "flow": 30333530, 
                        "maxBandwidthtime": 1560502500, 
                        "playerCount": 1
                    }, 
                    {
                        "area": "hebei", 
                        "bandwidth": 635065, 
                        "flow": 23814941, 
                        "maxBandwidthtime": 1560502500, 
                        "playerCount": 1
                    }
                ], 
                "endTime": "2019-06-14T08:55:00Z", 
                "startTime": "2019-06-14T08:50:00Z"
            }, 
            {
                "data": [
                    {
                        "area": "beijing", 
                        "bandwidth": 1224631, 
                        "flow": 45923689, 
                        "maxBandwidthtime": 1560502800, 
                        "playerCount": 1
                    }, 
                    {
                        "area": "hebei", 
                        "bandwidth": 1326398, 
                        "flow": 49739930, 
                        "maxBandwidthtime": 1560502800, 
                        "playerCount": 1
                    }
                ], 
                "endTime": "2019-06-14T09:00:00Z", 
                "startTime": "2019-06-14T08:55:00Z"
            }
        ]
    }
}
更新时间:2019-07-16 16:48:47
文档反馈 docs feedback