6.4 分页查询员工账户明细
# 6.4 分页查询员工账户明细
# 接口URL
{开放平台域名地址}/openApi/open/coins/getUserAccountCardDetail
注: 1、该接口为分页接口,当返回的结果条数等于itemsPerPage的条数时,请进行下一页查询,否则终止查询
2、该接口页码最大为500
3、分页查询企业员工账户明细(签收状态、卡状态、过期信息、锁定信息等)
# HTTP请求方式
POST
# 公共参数
| 字段 | 类型 | 是否必填 | 中文意描述 |
|---|---|---|---|
| access_token | String | 是 | 授权访问凭证 |
| timestamp | String | 是 | 毫秒级时间戳 防止重复攻击 |
| sign | String | 是 | 签名 |
| version | String | 否 | 业务接口版本号,如1.0.0 |
# body参数
| 字段 | 类型 | 是否必填 | 中文意描述 |
|---|---|---|---|
| currentPage | Integer | 否 | 页码,默认1 |
| itemsPerPage | Integer | 否 | 页数,默认100,最大500 |
# 请求示例
POST /openApi/open/coins/getUserAccountCardDetail?access_token=abc×tamp=1597300776947&sign=fa66cb4d8604413b8fb30afd32e3e73e HTTP/1.1 Content-Type: application/json Cache-Control: no-cache { "currentPage":1, "itemsPerPage":10 }1
2
3
4
5
6
7
# 返回参数说明
| 字段 | 类型 | 中文意描述 |
|---|---|---|
| code | String | 返回码 |
| data | ResponseData | 相应报文 |
| msg | String | 如果错误,返回错误信息 |
ResponseData:
| 字段 | 类型 | 中文意描述 |
|---|---|---|
| account | String | 账号 |
| balance | String | 剩余数量 |
| blockedInfo | String | 锁定信息 |
| cardContractId | String | 合同编号 |
| cardId | String | 卡号 |
| cardStatus | String | 卡状态:1:激活 2:锁定 |
| companyName | String | 单位名称 |
| departmentNames | String | 部门名称 |
| expiredTime | String | 到期时间 格式 yyyy-MM-dd HH:mm:ss |
| initiationStatus | String | 员工状态 |
| kindName | String | 卡种名称 |
| mobile | String | 手机号 |
| outdatedInfo | String | 过期信息 |
| signStatusString | String | 签收状态 1需要签收未签收 2 不需要签收 3 已签收 |
| status | String | 账号状态 |
| userName | String | 姓名 |
| value | String | 卡面金额/次数 |
# 返回示例
success:
{
"code": "0",
"data": [
{
"account": "abc",
"userName": "",
"mobile": "13011112222",
"initiationStatus": "在职",
"departmentNames": "百福得测试工会",
"companyName": "百福得测试工会",
"status": "正常",
"cardContractId": "123",
"value": "1000.000",
"cardId": "123",
"kindName": "体检健康A-测试",
"cardStatus": "已激活",
"balance": "317.980",
"signStatusString": "无需签收",
"outdatedInfo": "未过期",
"blockedInfo": "未锁定",
"expiredTime": "2023-09-24 00:00:00"
}
],
"msg": "success"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
fail:
{
"code": "10016",
"data": null,
"msg": "签名错误"
}
1
2
3
4
5
2
3
4
5