诺云开放平台

Appearance

直播间打卡用户信息 ​

请求路径 ​

  • 请求方式：POST
  • 请求头：Content-Type:application/json
  • 接口地址：https://gateway.nuoyunapi.com/Api/CheckIn/roomCheckInList/2.0.0
  • 频率限制：10秒100次

请求参数 ​

参数必选类型描述
room_id是integer直播间ID
page是integer页数，从1开始
page_size是integer每页记录数
start_time否integer开始时间戳（秒）
end_time否integer结束时间戳（秒）
wechat_user_space_id否integer用户wusid，用于筛选特定用户

请求示例 ​

json
{
    "room_id": 123456,
    "page": 1,
    "page_size": 10,
    "start_time": 1640966400,
    "end_time": 1641052800,
    "wechat_user_space_id": 0,
    "uid": 12345
}

响应参数 ​

参数必选类型描述
code是integer状态码：200-成功，400-失败
msg是string提示信息
data是object消息内容

data 参数结构 ​

参数必选类型描述
total是integer总用户数
page是integer当前页
page_size是integer每页记录数
list是array打卡用户列表

list 参数结构 ​

参数必选类型描述
wechat_user_space_id是integer打卡用户ID
name是string打卡用户昵称
photo是string打卡用户头像URL
check_in_num是integer打卡总次数
check_in_list是array打卡记录列表
invite_info是object渠道邀请信息
channel是object渠道归属门店信息

check_in_list 参数结构 ​

参数必选类型描述
wechat_user_space_id是integer打卡用户wusid
id是integer打卡记录ID
times_id是integer打卡场次ID
config_id是integer打卡配置ID
add_time是integer打卡时间戳（秒）

invite_info 参数结构 ​

参数必选类型描述
channel_sale_id是integer销售员ID
channel_sale_wechat_user_space_id是integer销售员用户信息
channel_sale_name是string销售员名称
channel_invite_name是string真实邀请人销售员名称
channel_invite_wechat_user_space_id是integer真实邀请人销售员用户ID

channel 参数结构 ​

参数必选类型描述
channel_id是integer门店ID
channel_name是string门店名称
channel_director_id是integer门店负责人ID
channel_director_wechat_user_space_id是integer门店负责人用户ID
channel_director_name是string门店负责人名称

响应示例 ​

json
{
    "code": 200,
    "data": {
        "total": 1,
        "page": 1,
        "page_size": 10,
        "list": [
            {
                "wechat_user_space_id": 123456,
                "name": "用户昵称",
                "photo": "https://example.com/avatar.jpg",
                "check_in_num": 1,
                "check_in_list": [
                    {
                        "wechat_user_space_id": 123456,
                        "id": 1001,
                        "times_id": 2001,
                        "config_id": 3001,
                        "add_time": 1640966400
                    }
                ],
                "invite_info": {
                    "channel_sale_id": 1001,
                    "channel_sale_wechat_user_space_id": 12345,
                    "channel_sale_name": "销售员姓名",
                    "channel_invite_name": "邀请人姓名",
                    "channel_invite_wechat_user_space_id": 12346
                },
                "channel": {
                    "channel_id": 1001,
                    "channel_name": "门店名称",
                    "channel_director_id": 2001,
                    "channel_director_wechat_user_space_id": 12347,
                    "channel_director_name": "负责人姓名"
                }
            }
        ]
    },
    "msg": "Success"
}