获取直播属性信息

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"
        }
    ]
}