获取用户播放记录日志

更新时间:2020-09-30

1. v3版本

接口描述
该接口用于查询用户所有播放记录日志,v3接口在v2基础上,终端细化到Flash、H5-PC、Android、iOS、H5-移动等。
请求地址
https://spark.bokecc.com/api/playlog/user/v3
请求方式
GET
请求参数

以下请求参数需要进行THQS权限认证, 权限认证方式请参考THQS认证方式

名称 类型 必填 描述
userid String 用户ID。
date String 查询日期,日期不能大于今日,格式:yyyy-MM-dd。
num_per_page Integer 分页参数,每页显示数量,默认为5000。取值范围:1~5000之间的任意整数。
page Integer 分页参数,页码,默认为1。取值范围:大于0的整数。
请求示例
https://spark.bokecc.com/api/playlog/user/v3?date=2017-07-06&page=1&time=1671618580230&userid=CC443A6686737xxx&hash=97EB5BCEFA0E09BCCB95881D879D1F91&num_per_page=100
返回数据
名称 类型 说明
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版本

接口描述
该接口用于查询用户所有播放记录日志,v2在v1基础上增加分页查询功能。
请求地址
https://spark.bokecc.com/api/playlog/user/v2
请求方式
GET
请求参数

以下请求参数需要进行THQS权限认证, 权限认证方式请参考THQS认证方式

名称 类型 必填 描述
userid String 用户ID。
date String 查询日期,日期不能大于今日,格式:yyyy-MM-dd。
num_per_page Integer 分页参数,每页显示数量,默认为5000。取值范围:1~5000之间的任意整数。
page Integer 分页参数,页码,默认为1。取值范围:大于0的整数。
请求示例
https://spark.bokecc.com/api/playlog/user/v2?date=2017-07-06&page=1&time=1671618580230&userid=CC443A6686737xxx&hash=97EB5BCEFA0E09BCCB95881D879D1F91&num_per_page=100
返回数据
名称 类型 说明
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"
            },
          ......
        ]
    }
}

results matching ""

    No results matching ""