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