查询账户账本

分页读取余额变化的不可变账本事件。

GET/api/v1/account/ledger

浏览常用接口

接口说明

账本事件用于核对充值、授权、结算与退款。调用方应使用稳定事件类型和金额字段，不要从展示文案反推业务状态。

认证：Bearer API Key

请求

查询参数

名称	类型	说明
`page`	integer	页码，从 1 开始。
`page_size`	integer	每页 1–100 条，默认 20。
`event_type`	string	按稳定账本事件类型过滤。

响应

JSON 接口使用统一响应信封。HTTP 状态表达请求结果，业务错误不会伪装成 HTTP 200。

HTTP	含义
`200`	请求成功
`400`	业务参数或过滤条件无效
`401`	缺少或无效的 API Key
`403`	API Key 已禁用或无权访问
`422`	请求结构校验失败
`500`	服务内部错误

完整成功响应示例（可选字段可能因状态不同而变化）

{
  "code": 0,
  "message": "success",
  "data": {
    "items": [],
    "total": 0,
    "page": 1,
    "page_size": 20
  },
  "request_id": "8f25b42f-2ed1-4ad7-99de-61d7f779bc7b",
  "timestamp": "2026-08-10T00:00:00Z"
}

重要边界

只读查询不会改变余额或任务状态。

查看机器可读 OpenAPI

代码与在线调试

GET · /api/v1/account/ledger

curl -X GET "$OGA_BASE_URL/api/v1/account/ledger?page=1&page_size=20&event_type=settlement" \
  -H "Authorization: Bearer <YOUR_OGA_API_KEY>" \
  -H "X-Request-Id: <UUID_V4>" \
  -H "Accept-Language: zh-CN"

请求只发送到当前网站同源的固定接口。API Key 只保留在本页密码框内；页面不会把它写入 URL、持久化数据或复制示例。

响应