获取直播属性信息
API 地址
api.vhallyun.com/api/v2/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 | 是 | 统计时间 |
错误码
| 错误码 | 类型 | 含义 |
|---|---|---|
| 10008 | int | 房间ID不能为空 |
| 10020 | int | 开始时间不能为空 |
| 20011 | int | 房间使用信息查询为空 |
| 20014 | int | 当前房间记录为空 |
| 30001 | int | 不是当前房间拥有者 |
| 40004 | int | 时间类型不正确 |
| 40008 | int | 分页起始提条目不正确 |
| 40009 | int | 分页条目不正确 |
| 40071 | int | 参数类型错误 |
响应格式
{
"code": 200,
"msg": "",
"data": [
{
"flow": 15015,
"bandwidth": 330,
"pv_num": 3,
"uv_num": 1,
"tt": 364,
"created_time": "2019-01-29 11:00:00"
},
{
"flow": 700,
"bandwidth": 193,
"pv_num": 1,
"uv_num": 1,
"tt": 29,
"created_time": "2019-01-29 12:00:00"
}
]
}
