获取视频播放记录日志
注:该接口可以根据视频id查询所有播放记录日志(需要用户实现自定义参数播放统计功能)。目前共三个版本,最新版本为V3
1. v3版本
特殊说明
v3接口在v2增加分页查询功能基础上,终端细化到Flash、H5-PC、Android、iOS、H5-移动等。
请求地址
https://spark.bokecc.com/api/playlog/video/v3
请求参数
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
userid | String | 是 | 用户 id |
videoid | String | 是 | 视频 id |
date | String | 是 | 查询日期,日期不能大于今日,格式为yyyy-MM-dd |
num_per_page | Integer | 否 | 返回信息时,每页包含的日志条数 注:允许范围为1~5000 |
page | Integer | 否 | 当前页码,默认值:1 |
返回数据
名称 | 类型 | 说明 |
---|---|---|
play_logs | Object | 播放日志 |
play_logs说明
名称 | 类型 | 说明 |
---|---|---|
total | Integer | 返回日志条数 |
play_log | Array | 播放日志信息 |
play_log说明
名称 | 类型 | 说明 |
---|---|---|
upid | Integer | 每次播放时产生的随机数字 |
userid | String | 用户 id |
videoid | String | 视频 id |
custom_id | String | 自定义 id |
play_duration | Integer | 播放时长 |
play_position | Integer | 最后播放位置 |
video_duration | Integer | 视频时长 |
ip | String | ip地址 |
province | String | 省份名称 |
city | String | 城市名称 |
referer | String | 来源域名 |
device | String | 设备类型 |
operating_system | String | 操作系统 |
browser | String | 浏览器类型 |
terminal | String | 终端类型 |
start_time | String | 开始播放时间 |
end_time | String | 结束播放时间 |
示例
{
"play_logs": {
"total": 1000,
"play_log": [
{
"upid": 4874841499354241000,
"userid": "2D505A62B40080E8",
"videoid": "B2F8FBF8A06B723B9C33DC5",
"custom_id": "record1",
"play_duration": 20000,
"play_position": 9622,
"video_duration": 262686,
"ip": "202.189.0.2",
"province": "北京市",
"city": "北京市",
"referer": "www.bokecc.com",
"device": "PC",
"operating_system": "WIN7",
"browser": "IE 11",
"terminal": "PC",
"start_time": "2017-07-06 23:17:29",
"end_time": "2017-07-06 23:17:49"
},
...
]
}
}
2. v2版本
请求地址
https://spark.bokecc.com/api/playlog/video/v2
请求参数
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
userid | String | 是 | 用户 id |
videoid | String | 是 | 视频 id |
date | String | 是 | 查询日期,日期不能大于今日,格式为yyyy-MM-dd |
num_per_page | Integer | 否 | 返回信息时,每页包含的日志条数 注:允许范围为1~5000 |
page | Integer | 否 | 当前页码,默认值:1 |
返回数据
名称 | 类型 | 说明 |
---|---|---|
play_logs | Object | 播放日志 |
play_logs说明
名称 | 类型 | 说明 |
---|---|---|
total | Integer | 返回日志条数 |
play_log | Array | 播放日志信息 |
play_log说明
名称 | 类型 | 说明 |
---|---|---|
upid | Integer | 每次播放时产生的随机数字 |
userid | String | 用户 id |
videoid | String | 视频 id |
custom_id | String | 自定义 id |
play_duration | Integer | 播放时长 |
play_position | Integer | 最后播放位置 |
video_duration | Integer | 视频时长 |
ip | String | ip地址 |
province | String | 省份名称 |
city | String | 城市名称 |
referer | String | 来源域名 |
device | String | 设备类型 |
operating_system | String | 操作系统 |
browser | String | 浏览器类型 |
terminal | String | 终端类型 |
start_time | String | 开始播放时间 |
end_time | String | 结束播放时间 |
示例
{
"play_logs": {
"total": 1000,
"play_log": [
{
"upid": 4874841499354241000,
"userid": "2D505A62B40080E8",
"videoid": "B2F8FBF8A06B723B9C33DC5",
"custom_id": "record1",
"play_duration": 20000,
"play_position": 9622,
"video_duration": 262686,
"ip": "202.189.0.2",
"province": "北京市",
"city": "北京市",
"referer": "www.bokecc.com",
"device": "PC",
"operating_system": "WIN7",
"browser": "IE 11",
"terminal": "PC",
"start_time": "2017-07-06 23:17:29",
"end_time": "2017-07-06 23:17:49"
},
...
]
}
}
3. v1版本
请求地址
https://spark.bokecc.com/api/playlog/video
请求参数
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
userid | String | 是 | 用户 id |
videoid | String | 是 | 视频 id |
date | String | 是 | 查询日期,日期不能大于今日,格式为yyyy-MM-dd |
返回数据
名称 | 类型 | 说明 |
---|---|---|
play_logs | Object | 播放日志 |
play_logs说明
名称 | 类型 | 说明 |
---|---|---|
play_log | Array | 播放日志信息 |
play_log说明
名称 | 类型 | 说明 |
---|---|---|
upid | Integer | 每次播放时产生的随机数字 |
userid | String | 用户 id |
videoid | String | 视频 id |
custom_id | String | 自定义 id |
play_duration | Integer | 播放时长 |
play_position | Integer | 最后播放位置 |
video_duration | Integer | 视频时长 |
ip | String | ip地址 |
province | String | 省份名称 |
city | String | 城市名称 |
referer | String | 来源域名 |
device | String | 设备类型 |
operating_system | String | 操作系统 |
browser | String | 浏览器类型 |
terminal | String | 终端类型 |
start_time | String | 开始播放时间 |
end_time | String | 结束播放时间 |
示例
{
"play_logs": {
"play_log": [
{
"upid": 4874841499354241000,
"userid": "2D505A62B40080E8",
"videoid": "B2F8FBF8A06B723B9C33DC5",
"custom_id": "record1",
"play_duration": 20000,
"play_position": 9622,
"video_duration": 262686,
"ip": "202.189.0.2",
"province": "北京市",
"city": "北京市",
"referer": "www.bokecc.com",
"device": "PC",
"operating_system": "WIN7",
"browser": "IE 11",
"terminal": "PC",
"start_time": "2017-07-06 23:17:29",
"end_time": "2017-07-06 23:17:49"
},
...
]
}
}