查询回放观看统计时长
更新时间:2022-12-28
接口描述
查询观看回放时长统计
说明:只有观看过回放才会生成时长统计数据,观看过后大约2小时后才会生成该数据,只对互动模式类型的直播间有效
请求地址
https://ccapi.csslcloud.net/openapi/recorder/replay/viewInfo
请求方式
GET
请求参数
接口统一权限认证请参考THQS认证方式。
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
accountId | String | 是 | 开发者账号ID |
liveId | String | 是 | 直播ID |
date | String | 是 | 日期,格式:yyyy-MM-dd,取值范围:该日期不能大于当前时间 |
pageNum | Integer | 否 | 第几页,默认1。取值范围:大于1的整数 |
pageSize | Integer | 否 | 每页记录条数,默认50。取值范围:1~500整数 |
请求示例
GET https://ccapi.csslcloud.net/openapi/recorder/replay/viewInfo?accountId=41E8063FC799ACE&date=2022-12-10&liveId=A01DD608E39FADC59C33DC5901307461&time=1670412086&hash={hash}
返回数据
公共返回数据结构请参考 公共返回数据说明。
字段名称 | 类型 | 描述 |
---|---|---|
total | Integer | 返回记录总条数 |
replayVideo | Array | 回放时长统计列表 |
replayVideo说明
字段名称 | 类型 | 描述 |
---|---|---|
customId | String | 用户ID,观看回放的用户Id |
videoId | String | 视频ID |
customName | String | 用户名称,观看回放的用户名称 |
videoDuration | Integer | 播放时长,单位:秒 |
ip | String | 观看端地址IP |
province | String | 观看用户所属省份 |
city | String | 观看用户所属城市 |
startTime | String | 播放开始时间,格式:”yyyy-MM-dd HH:mm:ss“ |
endTime | String | 播放结束时间,格式:”yyyy-MM-dd HH:mm:ss“ |
返回示例
{
"result": "OK",
"error": null,
"data": {
"total": 7,
"replayVideo": [
{
"customId": "8Vtkt2NBhGhGGhBW",
"videoId": "9BCDA48268E04BF713358DE27D943A99",
"customName": "MzEzOTQ5",
"videoDuration": 620,
"ip": "192.168.203.101",
"province": "未知",
"city": "未知",
"startTime": "2022-07-11 14:39:34",
"endTime": "2022-07-11 14:49:54"
}
]
},
"errorMsg": ""
}