获取视频自定义参数播放记录日志

注:该接口可以根据用户自定义的customid获取某视频播放记录日志(需要用户实现自定义参数播放统计功能)。目前共三个版本,最新版本为V3

1. v3版本

特殊说明

v3接口在v2增加分页查询功能基础上,终端细化到Flash、H5-PC、Android、iOS、H5-移动等。

请求地址

https://spark.bokecc.com/api/playlog/custom/video/v3

请求参数

名称 类型 必填 描述
userid String 用户 id
videoid String 视频 id
customid String 自定义 id,String类型,最大长度为100
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/custom/video/v2

请求参数

名称 类型 必填 描述
userid String 用户 id
videoid String 视频 id
customid String 自定义 id,最大长度为100
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/custom/video

请求参数

名称 类型 必填 描述
userid String 用户 id
videoid String 视频 id
customid String 自定义 id,最大长度为100
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"
            },
          ...
        ]
    }
}

results matching ""

    No results matching ""