获取直播属性信息
API 地址
api.yun.vhall.com/api/v1/room/get-room-use-info
描述
获取直播房间的流量、宽带、pv、uv以及观看时长
入参
关于公共请求参数详细内容,请参考 公共请求参数。
参数 | 类型 | 是否必选 | 含义 |
---|---|---|---|
room_id | string | 是 | 房间ID |
pos | int | 否 | 获取条目节点,默认为 0。 eg : 10 从第10条开始查询 |
limit | int | 否 | 获取条目数量,默认为 10 条,最大为1000条 |
start_time | date | 是 | 查询开始时间,格式为:2017/01/01 |
end_time | date | 否 | 查询结束时间,默认为当前时间,格式为:2017/01/01 |
出参
参数 | 类型 | 是否必选 | 含义 |
---|---|---|---|
flow | int | 是 | 流量 单位(KB) |
bandwidth | int | 是 | 带宽 单位 (kbps) |
pv_num | int | 是 | pv |
uv_num | int | 是 | uv |
tt | int | 是 | 总观看时长 单位 (秒) |
created_time | date | 是 | 统计时间 |
错误码
错误码 | 类型 | 含义 |
---|---|---|
10020 | int | 开始时间不能为空 |
20011 | int | 房间使用信息查询为空 |
30001 | int | 不是当前房间拥有者 |
40004 | int | 时间类型不正确 |
40008 | int | 分页起始提条目不正确 |
40009 | int | 分页条目不正确 |
响应格式
{
"code": 200,
"msg": "",
"data": [
{
"flow": 15015,
"bandwidth": 330,
"pv_num": 3,
"uv_num": 1,
"tt": 364,
"created_time": "2019-01-29 12:00:00"
},
{
"flow": 700,
"bandwidth": 193,
"pv_num": 1,
"uv_num": 1,
"tt": 29,
"created_time": "2019-01-29 12:00:00"
}
]
}