Appearance
用户列表
历史版本
请求路径
- 请求方式:
POST - 请求头:
Content-Type:application/json - 接口地址:
/Third/User/getWechatUserListV2 - 频率限制:
10秒1000次
请求参数
| 参数 | 必选 | 类型 | 描述 |
|---|---|---|---|
| page | 是 | integer | 页码,从1开始 |
| page_size | 是 | integer | 每页条数。最大25 |
| last_visit_start | 否 | integer | 最后访问起始时间(包含当前时间) |
| last_visit_end | 否 | integer | 最后访问结束时间(包含当前时间) |
请求示例
json
{
"page": "1",
"page_size": "15",
"last_visit_start": 1699526333,
"last_visit_end": 1710228301
}响应参数
| 参数 | 必选 | 类型 | 描述 |
|---|---|---|---|
| code | 是 | integer | 状态码:200-成功,400-失败 |
| msg | 是 | string | 提示信息 |
| data | 是 | object | 消息内容 |
data 参数结构
| 参数 | 必选 | 类型 | 描述 |
|---|---|---|---|
| total | 是 | integer | 总记录数 |
| list | 是 | array | 用户列表 |
list 参数结构
| 参数 | 必选 | 类型 | 描述 |
|---|---|---|---|
| wechat_user_space_id | 是 | integer | 用户ID |
| shut_up | 是 | integer | 禁言:0-无,1-全部 |
| forbid | 是 | integer | 拉黑:0-无,1-全部 |
| shield | 是 | integer | 屏蔽:0-无,1-全部 |
| first_visit_time | 是 | integer | 首次访问时间 |
| last_visit_time | 是 | integer | 最近访问时间 |
| openid | 是 | string | openid |
| unionid | 是 | string | unionid |
| name | 是 | string | 用户昵称 |
| photo | 是 | string | 用户头像 |
| third_uuid | 否 | string | 三方系统用户id |
| third_wechat_info | 否 | array | 第三方微信信息 |
third_wechat_info 参数结构
| 参数 | 必选 | 类型 | 描述 |
|---|---|---|---|
| authorizer_appid | 是 | string | 第三方公众号appid |
| openid | 是 | string | 第三方openid |
| unionid | 否 | string | 第三方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"
}
]
}
]
}
}