获取用户维度下按小时统计的播放时长

更新时间:2023-03-28

1. v3版本

接口描述
该接口用于获取用户维度下按小时统计的播放时长数据,该版本接口返回结果中增加了微信小程序终端相关的数据内容。
请求地址
https://spark.bokecc.com/api/stats/playduration/user/hourly/v3
请求方式
GET
请求参数

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

名称 类型 必填 描述
userid String 用户ID。
date String 查询日期,日期不能超过今日,格式:yyyy-MM-dd。
请求示例
https://spark.bokecc.com/api/stats/playduration/user/hourly/v3?date=2023-03-24&userid=xxx&time=1679972735399&hash=9DE1E86001949BF8A4B697A43EAD2CD5
返回数据
名称 类型 说明
play_durations Object 播放时长
play_durations说明
名称 类型 说明
play_duration Array 播放时长信息。
play_duration说明
名称 类型 说明
time String 表示小时的时间字符串,格式:yyyy-MM-dd HH:mm:ss。
flash Long Flash端播放时长,单位:秒。
pc_h5 Long H5-PC端播放时长,单位:秒。
android Long Android端播放时长,单位:秒。
ios Long iOS端播放时长,单位:秒。
mobile_h5 Long H5-移动端播放时长,单位:秒。
wechat Long 微信小程序端播放时长,单位:秒。
返回示例
{
    "play_durations": {
        "play_duration": [{
            "time": "2023-03-24 11:00:00",
            "flash": 1000,
            "pc_h5": 1000,
            "android": 1000,
            "ios": 1000,
            "mobile_h5": 1000,
            "wechat": 148
        }]
    }
}

2. v2版本

接口描述
该接口用于获取用户维度下按小时统计的播放时长数据,该版本接口返回结果中详细区分了各播放器终端的数据。
请求地址
https://spark.bokecc.com/api/stats/playduration/user/hourly/v2
请求方式
GET
请求参数

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

名称 类型 必填 描述
userid String 用户ID。
date String 查询日期,日期不能超过今日,格式:yyyy-MM-dd。
请求示例
https://spark.bokecc.com/api/stats/playduration/user/hourly/v2?date=2016-10-19&videoid=6D080640AF53B5D363835A29B2A11xxx&time=1671521568988&userid=CC443A6686737xxx&hash=026FF8D60CC4D18A2E74063684BC8FF0
返回数据
名称 类型 说明
play_durations Object 播放时长
play_durations说明
名称 类型 说明
play_duration Array 播放时长信息。
play_duration说明
名称 类型 说明
time String 表示小时的时间字符串,格式:yyyy-MM-dd HH:mm:ss。
flash Long Flash端播放时长,单位:秒。
pc_h5 Long H5-PC端播放时长,单位:秒。
android Long Android端播放时长,单位:秒。
ios Long iOS端播放时长,单位:秒。
mobile_h5 Long H5-移动端播放时长,单位:秒。
返回示例
{
    "play_durations": {
        "play_duration": [{
            "time": "2016-10-19 01:00:00",
            "flash": 20000,
            "pc_h5": 50000,
            "android": 10000,
            "ios": 30000,
            "mobile_h5": 20000
        }]
    }
}

3. v1版本

接口描述
该接口用于获取用户维度下按小时统计的播放时长数据,该版本接口返回结果中只区分了PC端和移动端的数据。
请求地址
https://spark.bokecc.com/api/stats/playduration/user/hourly
请求方式
GET
请求参数

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

名称 类型 必填 描述
userid String 用户ID。
date String 查询日期,日期不能超过今日,格式:yyyy-MM-dd。
请求示例
https://spark.bokecc.com/api/stats/playduration/user/hourly?date=2016-10-19&videoid=6D080640AF53B5D363835A29B2A11xxx&time=1671521568988&userid=CC443A6686737xxx&hash=026FF8D60CC4D18A2E74063684BC8FF0
返回数据
名称 类型 说明
play_durations Object 播放时长。
play_durations说明
名称 类型 说明
play_duration Array 播放时长信息。
play_duration说明
名称 类型 说明
time String 表示小时的时间字符串,格式:yyyy-MM-dd HH:mm:ss。
pc Long PC端播放时长,单位:秒。
mobile Long 移动端播时长,单位:秒。
返回示例
{
    "play_durations": {
        "play_duration": [{
            "time": "2016-10-19 01:00:00",
            "pc": 30000,
            "mobile": 40000
        }]
    }
}

results matching ""

    No results matching ""