获取视频播放记录日志

优质
小牛编辑
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视频时长
ipip地址
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视频时长
ipip地址
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视频时长
ipip地址
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"
            },
            …
        ]
    }
}