查询企业账户充值记录
接口路径
http
GET /api/enterprise/:id/recharge-records配额计算说明
amount 为配额变化(内部额度单位),换算成金额(人民币)的方式:
金额(¥) = amount ÷ quota_per_unit × usd_exchange_rate其中:
amount:来自本接口返回的充值记录中的amountquota_per_unit、usd_exchange_rate、quota_display_type:来自 查询换算参数 接口(GET /api/open/status)
若 quota_display_type = USD(美元),则去掉 × usd_exchange_rate。
请求参数
| 字段 | 类型 | 是否必传 | 说明 | 限制条件 | 备注 |
|---|---|---|---|---|---|
| id | int | 是 | 企业ID | 路径参数 | 示例: 1001 |
| p | int | 否 | 页码 | 默认为 1 | 示例: 1 |
| page_size | int | 否 | 每页条数 | 默认为 10,最大 100 | 示例: 20 |
请求示例
JSON
GET 'https://neolink.com/backend/api/enterprise/1001/recharge-records?p=1&page_size=20'
GET 'https://neolink.com/backend/api/enterprise/1001/recharge-records?p=1&page_size=20&record_type=manual_topup'
GET 'https://neolink.com/backend/api/enterprise/1001/recharge-records?page_size=10&record_type=redemption'返回信息
| 字段 | 类型 | 是否必传 | 说明 | 备注 |
|---|---|---|---|---|
| success | bool | 是 | 请求是否成功 | 固定值 |
| message | string | 是 | 错误提示信息(成功时为空) | 固定值 |
| data | PagedRechargeRecord | 是 | 分页充值记录对象 | 详见下表 |
PagedRechargeRecord 对象
| 字段 | 类型 | 是否必传 | 说明 | 备注 |
|---|---|---|---|---|
| page | int | 是 | 当前页码 | 从 1 开始 |
| page_size | int | 是 | 每页条数 | 返回的实际记录数 |
| total | int | 是 | 总记录数 | 满足条件的充值记录总数 |
| items | []RechargeRecord | 是 | 充值记录数组 | 详见下表 |
RechargeRecord 对象
| 字段 | 类型 | 是否必传 | 说明 | 备注 |
|---|---|---|---|---|
| id | int | 是 | 记录 ID | 数据库唯一标识 |
| type | string | 是 | 充值类型 | "topup"=充值;"redemption"=兑现 |
| time | int64 | 是 | 操作时间 | Unix 秒级时间戳 |
| amount | int64 | 是 | 配额变化 | 增加/减少的配额数;换算见上文「配额计算说明」 |
| operator | string | 是 | 操作人 | 执行该操作的用户或系统账号 |
| remark | string | 是 | 备注 | 附加说明 |
返回示例
JSON
成功响应
{
"success": true,
"message": "",
"data": {
"page": 1,
"page_size": 20,
"total": 35,
"items": [
{
"id": 1,
"type": "redemption",
"time": 1711468800,
"amount": 100000,
"operator": "",
"remark": ""
}
]
}
}