批量获取用户积分列表

拥有此API的权限集
积分管理-查询

请求方式及url

• 请求方式：POST
• 请求头：Content-Type:application/json
• 接口地址：https://api.xiaoe-tech.com/xe.account.info.batch/1.0.0
• 频率限制: 10秒500次

接口调试

GETPOSTPUTDELETE

https://api-doc.xiaoe-tech.com/_agent/forward?url=https://api.xiaoe-tech.com/

请求参数

响应结果

暂无响应数据

请求参数

参数名	必选	类型	说明	备注
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            // 总数
        }
    }
}