GET
/api/billing/logs资金流水明细
获取当前账户的计费与资金流水明细记录。该接口支持分页，返回包含流水 ID、变动金额、变动后余额、交易类型和描述的详细日志。
Query 参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
page | integer | 否 | 当前页码（从 1 开始），默认为 1。 |
page_size | integer | 否 | 每页返回的记录数，默认为 20，最大 100。 |
action_type | string | 否 | 交易类型过滤。传 recharge 会自动匹配所有充值类记录（包含 Deposit、System Grant、管理员充值 和 管理员赠金）。也可以直接传具体类型如 Traffic Cost 进行精确过滤。 |
返回值字段说明
响应数据结构
CurrentPage当前页码。
TotalPages总页数。
Total当前筛选条件下的总记录数。
LogsArray 单页的详细执行日志数组。详细字段如下：
ID日志记录的唯一标识。
ActionType 操作类型。当前系统存在以下类型：
Traffic Cost：流量计费扣款。Deposit：用户充值入账（含在线支付、授权码兑换）。System Grant：系统自动发放（如新用户注册赠金、VIP 充值赠送）。管理员充值/管理员赠金：后台管理员或代理商人工拨付。内部转账：账户内部资金流转（如推广佣金转余额）。Bonus Expired：赠金过期，系统自动回收扣款。
Amount变动金额。正数代表入账，负数代表扣款。
BalanceAfter操作完成后的账户剩余可用余额。
Description资金变动的业务说明详情。
RelatedID关联的业务主体 ID（如充值或支付产生的订单号，若无则为空字符串）。
CreatedAt记录生成时间。
GET
curl -X GET "https://www.kuaipai.ai/api/billing/logs?page=1" \ -H "Authorization: Bearer YOUR_API_KEY"
成功响应示例
{
"success": true,
"data": {
"CurrentPage": 1,
"TotalPages": 5,
"Total": 98,
"Logs": [
{
"ID": 10542,
"ActionType": "Traffic Cost",
"Amount": "-0.50",
"BalanceAfter": "98.50",
"Description": "关键词 example 成功匹配计费",
"RelatedID": "",
"CreatedAt": "2023-10-01 12:00:00"
}
]
}
}