批量获取用户积分列表
| 拥有此API的权限集 |
|---|
| 积分管理-查询 |
请求方式及url
- 请求方式：
POST - 请求头：
Content-Type:application/json - 接口地址：
https://api.xiaoe-tech.com/xe.account.info.batch/1.0.0 - 频率限制:
10秒500次
在线调试工具
请求
响应
请求参数
| 参数名 | 必选 | 类型 | 说明 | 备注 |
|---|---|---|---|---|
| access_token | 是 | string | 专属token | ... |
| create_time_start | 否 | string | 首次获取积分的时间-- 开始 | ... |
| create_time_end | 否 | string | 首次获取积分的时间-- 结束 | ... |
| user_ids | 是 | array | 需要查询的用户id（注：空数组也参与查询，如果不参与查询请传null或者空字符串 | 上限100 |
| sort_rule | 否 | int | 排序规则 | # 11-总积分降序 12-总积分升序# 21-可用积分降序 22-可用积分升序# 31-冻结积分降序 32-冻结积分升序；不传默认ID倒序排序 |
| page_size | 是 | string | 每页展示的条数 | ... |
| page | 是 | string | 页码 | ... |
请求示例
{
"access_token": "xe_xxxxx",
"create_time_start": "2020-08-13 00:00:00", // 首次获取积分的时间-- 开始
"create_time_end": "2020-08-20 00:00:00",// 首次获取积分的时间-- 结束
"user_ids": [ // 需要查询的用户id（注：空数组也参与查询，如果不参与查询请传null或者空字符串）
"user_id_1",
"user_id_2",
"user_id_3"
],
# 11-总积分降序 12-总积分升序
# 21-可用积分降序 22-可用积分升序
# 31-冻结积分降序 32-冻结积分升序
"sort_rule": 11, # 总积分排序规则
"page_size": "10", // 每页展示的条数
"page": "1" // 页码
}
返回参数
| 参数名 | 必选 | 类型 | 说明 | 备注 |
|---|---|---|---|---|
| code | 是 | int | 返回码 | 0为成功，其它为失败，具体错误码详情见说明 |
| msg | 是 | string | 消息详情 | ... |
| data | 是 | string | 返回参数 | 具体内容见下表data说明 |
返回data字段参数
| 参数名 | 类型 | 说明 | 备注 |
|---|---|---|---|
| list | array | 店铺ID | ... |
| page | string | 页面信息 | ... |
返回list字段参数
| 参数名 | 类型 | 说明 | 备注 |
|---|---|---|---|
| id | int | ID | ... |
| app_id | string | 店铺id | ... |
| user_id | string | 用户id | ... |
| total_balance | int | 总积分 | ... |
| balance | int | 可用积分 | ... |
| freeze_balance | int | 页面信息 | ... |
| created_at | string | 首次获取积分时间 | ... |
返回page字段参数
| 参数名 | 类型 | 说明 | 备注 |
|---|---|---|---|
| current_page | int | 当前页码 | ... |
| last_page | int | 最后一页 | ... |
| page_size | int | 每页的条数 | ... |
| total | int | 总数 | ... |
返回示例
{
"code": 0,
"msg": "Success",
"data": {
"list": [ //列表数据
{
"id": 5,
"app_id": "app_id_xxxx",
"user_id": "xxxx_1", // 用户id
"total_balance": 0, // 总积分
"balance": 300, // 可用积分
"freeze_balance": 0, // 冻结积分
"created_at": "2020-08-20 16:01:52" // 首次获取积分时间
},
{
"id": 6,
"app_id": "app_id_xxxx",
"user_id": "xxxx_2",
"total_balance": 0,
"balance": 300,
"freeze_balance": 0,
"created_at": "2020-08-20 16:01:52"
}
],
"page": { // 页面信息
"current_page": 3, // 当前页码
"last_page": 4, // 最后一页
"page_size": 2, // 每页的条数
"total": 7 // 总数
}
}
}