计费

查询交易流水需要认证免费

GET/v1/billing/transactions

接口说明

分页查询当前开发者的计费交易记录，包括充值、扣费、解冻等所有资金变动。

主要用途：

查看账户的充值和消费历史
追踪特定任务的扣费情况
对账和审计

查询参数：

limit：可选，每页返回的记录数，默认 20，最小 1，最大 100
offset：可选，偏移量，默认 0，用于分页

返回值： 返回交易记录数组，每条记录包含：

id：交易 ID
type：交易类型
- recharge：充值
- freeze：冻结（任务提交时）
- confirm：确认扣费（任务完成时）
- refund：解冻返还（任务失败时）
amount：交易金额，正数为收入，负数为支出
routeKey：关联的接口资源标识，如 cards.generate
taskId：关联的任务 ID，仅当交易由任务产生时有值
description：交易描述
createdAt：交易时间（ISO 8601 格式）

排序说明：

交易记录按时间倒序排列，最新的交易在最前

分页示例：

第一页：limit=20, offset=0
第二页：limit=20, offset=20
第三页：limit=20, offset=40

授权说明：

需要提供有效的 API Key（Bearer Token）
此接口不收费

请求头

参数类型必填说明

Authorizationstring是

从 Memene API 开放平台获取的 API Key。是 Bearer Token 格式，例如：Bearer sk_memene_xxx_yyy。可以点击此处获取 API KEY

请求参数

参数类型必填说明

limitstring否

每页记录数（默认 20，最大 100）

offsetstring否

偏移量（默认 0）

响应结构

200

Default Response

application/json

示例

json

[
  {
    "id": "tx_001",
    "type": "confirm",
    "amount": "-0.10",
    "routeKey": "cards.generate",
    "routeName": null,
    "taskId": "task_abc123",
    "description": "卡片生成扣费",
    "createdAt": "2025-03-15T08:30:00Z"
  }
]