获取视频播放记录日志
优质
小牛编辑
127浏览
2023-12-01
通过该接口可以根据视频id查询所有播放记录日志(需要用户实现自定义参数播放统计功能)。目前共三个版本,最新版本为V3:
a.当地址为https://spark.bokecc.com/api/playlog/video/v3
特殊说明:
第三版接口,在第二版增加分页查询功能基础上,终端细化到Flash、H5-PC、Android、iOS、H5-移动等。
需要传递以下参数:
参数 | 说明 |
---|---|
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.当地址为https://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"
},
…
]
}
}
c.当地址为https://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"
},
…
]
}
}