视频直播

视频直播

产品文档

视频直播

帮助中心 > OpenAPI & SDK > 视频直播 > 查询播放URL排行
搜本产品

describeUrlRanking

描述

查询URL播放排行

请求方式

GET

请求地址

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

请求参数

名称 类型 是否必需 默认值 描述
domainName String True 播放域名
size Integer False 查询Top数量，默认20，即返回Top20的数据
rankfield String False 排行依据字段，取值：["pv", "flow", "bandwidth"]，默认pv
- pv 播放次数
- flow 流量
- bandwidth 带宽
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
- 为空,默认为当前时间

返回参数

名称 类型 描述
result Result
requestId String requestId

Result

名称 类型 描述
dataList RankingUrlResult[ ]

RankingUrlResult

名称 类型 描述
rankingList RankingUrlResultData[ ]

RankingUrlResultData

名称 类型 描述
url String URL
rank Integer 排行序号
md5 String 文件md5
value Long 排行依据字段对应的数值
data RankingUrlResultRankData[ ]

RankingUrlResultRankData

名称 类型 描述
uv Long 独立访问数
bandwidth Long 带宽，单位：bps
pv 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/describeUrlRanking?domains=play.yourdomain.com&startTime=2018-10-21T10:00:00Z

返回示例

{
    "code": 200, 
    "requestId": "bkcu3ts60jt1f86ti756imamqaw18puj", 
    "result": {
        "rankingList": [
            {
                "data": {
                    "bandwidth": 1324, 
                    "flow": 59344, 
                    "pv": 118, 
                    "uv": 7
                }, 
                "rank": 1, 
                "url": "pl.jdcloud.com/ccc/copy.m3u8", 
                "value": 118
            }
        ]
    }
}
更新时间：2019-07-16 16:48:47
feedback