卡片信息查询
POST
/api/shop/card
接口概述
接口信息
https://xxx.com/api/shop/card请求头（Header）
| 参数名 | 类型 | 描述 | 示例值 |
|---|---|---|---|
| account | String | 账号 | account |
| pwd | String | 密码 | pwd |
| key | String | API 密钥 | key |
请求参数（Body）
| 参数名 | 类型 | 是否必填 | 描述 | 示例值 |
|---|---|---|---|---|
| card_id | String | 是 | 卡号 | 990000001 |
响应格式
查询成功响应
{
"code": 0,
"message": "查询成功",
"data": {
"card_id": "990000001",
"cash_balance": "88.88",
"subsidy_balance": "66.66",
"mobile": "15888888888"
"name": "王XX",
"identity_number": "7654321",
"department_name": "XXX项目部",
"parent_department_name": "XXXX公司"
},
"trace_id": "690ebaaa5e2cf"
}查询失败响应
{
"code": 1,
"message": "缺少参数",
"data": [],
"trace_id": "692931283c4d6"
}{
"code": 1,
"message": "卡号不存在或者异常",
"data": [],
"trace_id": "692931283c4d6"
}{
"code": 1,
"message": "查询失败",
"data": [],
"trace_id": "692931283c4d6"
}状态码说明
| 状态码 | 描述 |
|---|---|
| 0 | 查询成功 |
| 1 | 查询失败（通用错误） |
响应字段说明
| 字段名 | 类型 | 描述 |
|---|---|---|
| code | Integer | 状态码，0 表示成功，非 0 表示失败 |
| message | String | 响应消息，描述操作结果 |
| data | Object/Array | 响应数据，成功时包含卡片信息 |
| data.card_id | String | 卡号 |
| data.cash_balance | String | 现金余额 |
| data.subsidy_balance | String | 补贴余额 |
| data.mobile | String | 手机号 |
| data.name | String | 姓名 |
| data.identity_number | String | 身份证号 |
| data.department_name | String | 二级部门（举例：XXX项目部） |
| data.parent_department_name | String | 一级部门（举例：XXX公司） |
| trace_id | String | 追踪 ID，用于问题排查 |
trace_id 说明
trace_id字段用于接口调用的追踪和问题排查。当接口调用出现问题时，请提供该 ID 以便技术支持人员快速定位问题。请求参数
Header 参数
Body 参数application/json