GET /auth/credits/ledger
查询积分账本
REST API 概览 · OpenAPI JSON · OpenAPI YAML
| 稳定性 | 认证 | 费用 | Operation ID |
|---|---|---|---|
| 已发布 | Bearer API 密钥 | 免费 | get_credits_ledger_api_v1_auth_credits_ledger_get |
| 名称 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
start_date | query | 否 | string | null | 开始日期 (YYYY-MM-DD) |
end_date | query | 否 | string | null | 结束日期 (YYYY-MM-DD) |
entry_type | query | 否 | string | null | 账本事件类型 |
scope | query | 否 | string | null | 预定义账本范围,例如 account_history |
page | query | 否 | integer | 页码 |
page_size | query | 否 | integer | 每页数量 |
min_credits | query | 否 | number | null | — |
max_credits | query | 否 | number | null | — |
direction | query | 否 | string | — |
bucket | query | 否 | string | null | — |
summary | query | 否 | boolean | — |
limit | query | 否 | integer | null | — |
此操作没有 JSON 请求体。
curl --request GET \
--url "https://qveris.cn/api/v1/auth/credits/ledger" \
--header "Authorization: Bearer $QVERIS_API_KEY"
const response = await fetch("https://qveris.cn/api/v1/auth/credits/ledger", {
method: "GET",
headers: {
Authorization: `Bearer ${process.env.QVERIS_API_KEY}`,
},
})
if (!response.ok) throw new Error(`QVeris request failed: ${response.status}`)
console.log(await response.json())
import os
import requests
response = requests.request(
"GET",
"https://qveris.cn/api/v1/auth/credits/ledger",
headers={"Authorization": f"Bearer {os.environ['QVERIS_API_KEY']}"},
timeout=30,
)
response.raise_for_status()
print(response.json())
| 状态码 | 含义 | Schema |
|---|---|---|
200 | Successful Response | APIResponse_CreditsLedgerResponse_ |
400 | Invalid ledger query | APIResponse_dict_ |
422 | Validation Error | HTTPValidationError |
{
"status": "success",
"message": "Credits ledger retrieved successfully",
"status_code": 0,
"data": {
"items": [
{
"id": "led_01HZX9R39K6QZ",
"entry_type": "consume_tool_execute",
"amount_credits": -5,
"source_system": "qveris_website",
"source_ref_type": "execute_history",
"source_ref_id": "2b7f7c4a-9f3a-4f61-8b59-3a983a8192a0",
"execution_id": "exec_01HZX9R2R4S2E",
"pre_settlement_bill": {
"execution_id": "exec_01HZX9R2R4S2E",
"summary": "5 credits per successful request",
"list_amount_credits": 5
},
"settlement_result": {
"settled_amount_credits": 5
},
"balance_before": {
"total_available_credits": 995
},
"balance_after": {
"total_available_credits": 990
},
"description": "Tool execution charge",
"created_at": "2026-05-16T08:30:13Z"
}
],
"total": 1,
"page": 1,
"page_size": 50,
"summary": null
}
}
这个页面对你有帮助吗?