获取视频播放记录日志
通过该接口可以根据视频id查询所有播放记录日志(需要用户实现自定义参数播放统计功能)。
目前共两个版本,最新版本为V2:
a.当地址为http://spark.bokecc.com/api/playlog/video/v2
需要传递以下参数:
参数 | 说明 |
---|---|
userid | 用户 id,不可为空 |
videoid | 视频 id,不可为空 |
date | 查询日期,日期不能大于今日,格式为yyyy-MM-dd,不可为空 |
num_per_page | 返回信息时,每页包含的日志条数 注:允许范围为1~5000 |
page | 当前页码 |
返回数据play_logs包含如下字段:
字段名 | 说明 |
---|---|
total | 返回日志条数 |
play_log | 播放日志 |
play_log包含如下字段:
字段名 | 说明 |
---|---|
upid | 每次播放时产生的随机数字 |
userid | 用户 id |
videoid | 视频 id |
custom_id | 自定义 id |
play_duration | 播放时长 |
play_position | 最后播放位置 |
video_duration | 视频时长 |
ip | ip地址 |
province | 省份名称 |
city | 城市名称 |
referer | 来源域名 |
device | 设备类型 |
operating_system | 操作系统 |
browser | 浏览器类型 |
terminal | 终端类型 |
start_time | 开始播放时间 |
end_time | 结束播放时间 |
JSON格式的返回信息如下:
{
"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"
},
…
]
}
}
b.地址为:http://spark.bokecc.com/api/playlog/video
需要传递以下参数:
参数 | 说明 |
---|---|
userid | 用户 id,不可为空 |
videoid | 视频 id,不可为空 |
date | 查询日期,日期不能大于今日,格式为yyyy-MM-dd,不可为空 |
返回数据play_logs包含如下字段:
字段名 | 说明 |
---|---|
play_log | 播放日志 |
play_log包含如下字段:
字段名 | 说明 | |||
---|---|---|---|---|
upid | 每次播放时产生的随机数字 | |||
userid | 用户 id | videoid | 视频 id | |
custom_id | 自定义 id | |||
play_duration | 播放时长 | |||
play_position | 最后播放位置 | |||
video_duration | 视频时长 | |||
ip | ip地址 | |||
province | 省份名称 | |||
city | 城市名称 | |||
referer | 来源域名 | |||
device | 设备类型 | |||
operating_system | 操作系统 | |||
browser | 浏览器类型 | |||
terminal | 终端类型 | |||
start_time | 开始播放时间 | |||
end_time | 结束播放时间 |
JSON格式的返回信息如下:
{
"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"
},
…
]
}
}