简要描述:

  • 获取直播活动下所有用户观看详细数据信息

访问权限

账号类型 是否有权限
主账号
子账号

接口URL:

http://api.zmengzhu.com/business/v1/data/liveViewDetail

请求方式:

GET

返回结果格式:

JSON

参数:

参数名 是否必须 类型 默认 说明
channel_id int - 频道ID
webinar_id int - 活动ID
ticket_id int - 活动Ticket ID,如果传递ticket_id 则webinar_id可以为空
page int 1 页码
limit int 10 每页数量,每页最大数量50

返回示例:

响应成功JSON示例:

{
    "code": 200,
    "msg": "ok",
    "data": {
        list: [{
            "id": "470276",
            "channel_id": "3685385", // 频道ID
            "webinar_id": "86169", // 活动ID
            "uid": "4155023", // 用户ID
            "join_time": "2020-04-14 14:56:40", // 首次进入时间
            "leave_time": "2020-04-14 14:56:42", // 最后离开时间
            "duration": "0", // 累计观看时长
            "platform": "pc", // 观看终端
            "area": "局域网", // 地理位置
            "created_at": "1586849703", // 创建时间
            "webinar_start_time": "1586847283", // 活动开始时间
            "invite_uid": "3763910", // 邀请用户
            "ip": "192.168.0.150", // 访问IP
            "nickname": "茄子", // 昵称
            "phone": "", // 手机号
            "invite_nickname": "13383645727范德萨" // 邀请用户昵称
            "origin_unique_id":10976678 // 初始化第三方用户标识
        }],
        total: 1, // 总量
    },
}

字段说明:

参数名 说明
code 成功为200
msg 成功返回ok
channel_id 频道ID
webinar_id 活动ID
uid 用户ID
join_time 首次进入时间
leave_time 最后离开时间
duration 累计观看时长
platform 观看终端
area 地理位置
created_at 创建时间
webinar_start_time 活动开始时间
invite_uid 邀请用户
ip 访问IP
nickname 昵称
phone 手机号
invite_nickname 邀请用户昵称
origin_unique_id 初始化第三方用户标识
total 总量

错误时返回:

{
    "code": 20001,
    "msg": "签名校验失败",
    "data": {}
}