Skip to content

查询企业账户充值记录 ​

接口路径 ​

http
GET /api/enterprise/:id/recharge-records

配额计算说明 ​

amount 为配额变化(内部额度单位),换算成金额(人民币)的方式:

金额(¥) = amount ÷ quota_per_unit × usd_exchange_rate

其中:

  • amount:来自本接口返回的充值记录中的 amount
  • quota_per_unit、usd_exchange_rate、quota_display_type:来自 查询换算参数 接口(GET /api/open/status)

若 quota_display_type = USD(美元),则去掉 × usd_exchange_rate。

请求参数 ​

字段类型是否必传说明限制条件备注
idint是企业ID路径参数示例: 1001
pint否页码默认为 1示例: 1
page_sizeint否每页条数默认为 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'

返回信息 ​

字段类型是否必传说明备注
successbool是请求是否成功固定值
messagestring是错误提示信息(成功时为空)固定值
dataPagedRechargeRecord是分页充值记录对象详见下表

PagedRechargeRecord 对象

字段类型是否必传说明备注
pageint是当前页码从 1 开始
page_sizeint是每页条数返回的实际记录数
totalint是总记录数满足条件的充值记录总数
items[]RechargeRecord是充值记录数组详见下表

RechargeRecord 对象

字段类型是否必传说明备注
idint是记录 ID数据库唯一标识
typestring是充值类型"topup"=充值;"redemption"=兑现
timeint64是操作时间Unix 秒级时间戳
amountint64是配额变化增加/减少的配额数;换算见上文「配额计算说明」
operatorstring是操作人执行该操作的用户或系统账号
remarkstring是备注附加说明

返回示例 ​

JSON
成功响应
{
  "success": true,
  "message": "",
  "data": {
    "page": 1,
    "page_size": 20,
    "total": 35,
    "items": [
      {
        "id": 1,
        "type": "redemption",
        "time": 1711468800,
        "amount": 100000,
        "operator": "",
        "remark": ""
      }
    ]
  }
}