Skip to content

用户列表

历史版本

请求路径

  • 请求方式:POST
  • 请求头:Content-Type:application/json
  • 接口地址:/Third/User/getWechatUserListV2
  • 频率限制:10秒1000次

请求参数

参数必选类型描述
pageinteger页码,从1开始
page_sizeinteger每页条数。最大25
last_visit_startinteger最后访问起始时间(包含当前时间)
last_visit_endinteger最后访问结束时间(包含当前时间)

请求示例

json
{
    "page": "1",
    "page_size": "15",
    "last_visit_start": 1699526333,
    "last_visit_end": 1710228301
}

响应参数

参数必选类型描述
codeinteger状态码:200-成功,400-失败
msgstring提示信息
dataobject消息内容

data 参数结构

参数必选类型描述
totalinteger总记录数
listarray用户列表

list 参数结构

参数必选类型描述
wechat_user_space_idinteger用户ID
shut_upinteger禁言:0-无,1-全部
forbidinteger拉黑:0-无,1-全部
shieldinteger屏蔽:0-无,1-全部
first_visit_timeinteger首次访问时间
last_visit_timeinteger最近访问时间
openidstringopenid
unionidstringunionid
namestring用户昵称
photostring用户头像
third_uuidstring三方系统用户id
third_wechat_infoarray第三方微信信息

third_wechat_info 参数结构

参数必选类型描述
authorizer_appidstring第三方公众号appid
openidstring第三方openid
unionidstring第三方unionid

响应示例

json
{  
    "code": 200,  
    "msg": "",  
    "data": {  
        "total": 2,  
        "list": [  
            {  
                "wechat_user_space_id": 12345,  
                "shut_up": 0,  
                "forbid": 0,  
                "shield": 0,  
                "first_visit_time": 1303166722,  
                "last_visit_time": 1303166973,  
                "openid": "ox3qqxxxxBao",  
                "unionid": "o8-ysxxxxfa7CE",  
                "name": "小xxxx",  
                "photo": "https://nyfs.oss.nuoyun.tv/Uploads/WxHeadImg2023/2A0E/50B18F4CAE55E0B00A64D1E310652A0E.jpg",  
                "third_uuid": "user_123456",
                "third_wechat_info": [  
                    {  
                        "authorizer_appid": "wx3f2xxx3",  
                        "openid": "ox3qqxxxxBao",  
                        "unionid": "ysxxxxfa7CE"  
                    }  
                ]  
            }  
        ]  
    }  
}