批量查询获取用户信息
| 拥有此API的权限集 |
|---|
| 用户管理-查询 |
请求方式及url
- 请求方式：
POST - 请求头：
Content-Type:application/json - 接口地址：
https://api.xiaoe-tech.com/xe.user.batch_by_user_id.get/1.0.0 - 频率限制：
10秒1000次 - 注：该接口最大获取前10000条数据
在线调试工具
请求
响应
请求参数
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| access_token | 是 | string | 专属token |
| user_id_list | 是 | array | 用户user_id数组，最大50 |
| page | 是 | int | 页码，表示第几页，从1开始 |
| page_size | 是 | int | 每页条数，最大50条 |
请求示例
{
"access_token": "xxxxxxxx",
"user_id_list": [
"u_xxxx",
"u_xxxx",
"u_xxxx"
],
"page": 1,
"page_size": 3
}
返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码：0-成功，其他为错误 |
| message | string | 对返回码的文本描述内容 |
| data.list | array | 用户列表 |
| data.list.user_id | string | 用户id |
| data.list.wx_union_id | string | 微信union_id |
| data.list.wx_app_open_id | string | 小程序open_id |
| data.list.wx_open_id | string | 微信open_id |
| data.list.user_nickname | string | 用户昵称 |
| data.list.bind_phone | string | 绑定手机号 |
| data.list.collect_phone | string | 采集手机号 |
| data.list.avatar | string | 头像 |
| data.list.from | string | 用户来源：0-微信、1-sdk、2-字节跳动、3-百度、4-飞书企业内训、5-小班课app、6-通用h5、7-微博、8-B端导入、9-手机号注册、10-QQ |
| data.list.pay_sum | float | 消费总额（元） |
| data.list.punch_count | int | 购买次数 |
| data.list.user_created_at | string | 用户创建时间 |
| data.total | float | 查询结果记录数 |
返回示例
{
"code": 0,
"msg": "ok",
"data": {
"list": [
{
"user_id": "u_qq_xxxx",
"wx_union_id": "",
"wx_app_open_id": "",
"wx_open_id": "",
"user_nickname": "xxx",
"bind_phone": "",
"collect_phone": "",
"avatar": "xxxxx",
"from": "QQ",
"pay_sum": 0,
"punch_count": 0,
"user_created_at": "2021-08-03 11:37:48"
},
...
],
"total": 2
}
}
备注
- 更多返回错误代码请看首页的错误代码描述