6.3 分页查询福豆充值记录
# 6.3 分页查询福豆充值记录
# 接口URL
{开放平台域名地址}/openApi/open/coins/queryRechargeInfoPage
注: 1、该接口为分页接口,当返回的结果条数等于itemsPerPage的条数时,请进行下一页查询,否则终止查询
2、可通过时间范围查询,或直接根据充值单列表businessCode查询,两者二选一
3、如果选择时间范围查询,该接口起止查询时间不能大于30天;如果选择充值单列表查询,列表数量不能大于20
4、查询企业(businessType=6001福利发放、6002福豆自动回收)员工账户充值记录,businessCode为客户传递充值的单号
# HTTP请求方式
POST
# 公共参数
| 字段 | 类型 | 是否必填 | 中文意描述 |
|---|---|---|---|
| access_token | String | 是 | 授权访问凭证 |
| timestamp | String | 是 | 毫秒级时间戳 防止重复攻击 |
| sign | String | 是 | 签名 |
| version | String | 否 | 业务接口版本号,如1.0.0 |
# body参数
| 字段 | 类型 | 是否必填 | 中文意描述 |
|---|---|---|---|
| startTime | String | 是 | 起始时间 |
| endTime | String | 是 | 终止时间 |
| businessCodeList | String列表 | 是 | 充值单据号列表,一次最多支持20个单据 |
| currentPage | Integer | 是 | 页码 |
| itemsPerPage | Integer | 否 | 页数,默认20 |
# 请求示例
POST /openApi/open/coins/queryRechargeInfoPage?access_token=abc×tamp=1597300776947&sign=fa66cb4d8604413b8fb30afd32e3e73e HTTP/1.1 Content-Type: application/json Cache-Control: no-cache { "startTime":"2021-11-01 11:11:11", "endTime":"2022-11-30 11:11:11", "businessCodeList":["201101123855848957841123","201101123855848957841124"], "currentPage":1, "itemsPerPage":20 }1
2
3
4
5
6
7
8
9
10
# 返回参数说明
| 字段 | 类型 | 中文意描述 |
|---|---|---|
| code | String | 返回码 |
| data | ResponseData | 相应报文 |
| msg | String | 如果错误,返回错误信息 |
ResponseData:
| 字段 | 类型 | 中文意描述 |
|---|---|---|
| account | String | 账号 |
| amt | BigDecimal | 充值金额 |
| rechargeTime | String | 充值时间 |
| businessCode | String | 充值单号 |
| businessType | String | 交易类型(6001:充值,6002:退款) |
# 返回示例
success:
{
"code": "0",
"data": [
{
"account": "13120554421",
"amt": 1030.00,
"rechargeTime": "2021-11-01 11:11:11",
"businessCode": "201101123855848957841123",
"businessType": 6001
}
],
"msg": "success"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
2
3
4
5
6
7
8
9
10
11
12
13
fail:
{
"code": "10016",
"data": null,
"msg": "签名错误"
}
1
2
3
4
5
2
3
4
5