QVeris
运行任务
文档目录

查询使用历史

GET /auth/usage/history/v2

查询使用历史

REST API 概览 · OpenAPI JSON · OpenAPI YAML

接口契约

稳定性认证费用Operation ID
已发布Bearer API 密钥免费get_usage_history_v2_api_v1_auth_usage_history_v2_get

参数

名称位置必填类型说明
start_datequerystring | null开始日期 (YYYY-MM-DD)
end_datequerystring | null结束日期 (YYYY-MM-DD)
event_typequerystring | null事件类型过滤
kindquerystring | null事件分组过滤
successqueryboolean | null是否成功
billable_successqueryboolean | null是否可计费
outcomequerystring | null执行 outcome 过滤
reason_codequerystring | null执行 reason_code 过滤
has_execution_outcomequeryboolean | null是否存在 execution_outcome
charge_outcomequerystring | null收费结果过滤
anomalyquerystring | null异常类型过滤
search_idquerystring | nullsearch_id 聚焦过滤
execution_idquerystring | nullexecution_id 聚焦过滤
api_key_idquerystring | nullAPI Key 归因过滤
pagequeryinteger页码
page_sizequeryinteger每页数量
include_detailsqueryboolean是否在列表中返回完整审计详情字段
min_creditsquerynumber | null
max_creditsquerynumber | null
bucketquerystring | null
summaryqueryboolean
limitqueryinteger | null

请求体

此操作没有 JSON 请求体。

可运行示例

bash
curl --request GET \
  --url "https://qveris.ai/api/v1/auth/usage/history/v2" \
  --header "Authorization: Bearer $QVERIS_API_KEY"
typescript
const response = await fetch("https://qveris.ai/api/v1/auth/usage/history/v2", {
  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())
python
import os
import requests

response = requests.request(
    "GET",
    "https://qveris.ai/api/v1/auth/usage/history/v2",
    headers={"Authorization": f"Bearer {os.environ['QVERIS_API_KEY']}"},
    timeout=30,
)
response.raise_for_status()
print(response.json())

响应

状态码含义Schema
200Successful ResponseAPIResponse_UsageEventsResponse_
400Invalid audit queryAPIResponse_dict_
422Validation ErrorHTTPValidationError

成功响应示例

json
{
  "status": "success",
  "message": "Usage events retrieved successfully",
  "status_code": 0,
  "data": {
    "items": [
      {
        "id": "evt_01HZX9R31GH2R",
        "event_type": "tool_execute",
        "source_system": "qveris_website",
        "source_ref_type": "execute_history",
        "source_ref_id": "2b7f7c4a-9f3a-4f61-8b59-3a983a8192a0",
        "session_id": "sess_7Q9m",
        "search_id": "srch_01HZX9QK7J3M9T",
        "execution_id": "exec_01HZX9R2R4S2E",
        "tool_id": "openweathermap.weather.execute.v1",
        "success": true,
        "charge_outcome": "charged",
        "duration_ms": 211,
        "billing_snapshot_status": "upstream_provided",
        "pre_settlement_amount_credits": 5,
        "settled_amount_credits": 5,
        "actual_amount_credits": 5,
        "credits_ledger_entry_id": "led_01HZX9R39K6QZ",
        "display_target": "openweathermap.weather.execute.v1",
        "billing_summary": "5 credits per successful request",
        "created_at": "2026-05-16T08:30:12Z"
      }
    ],
    "total": 1,
    "page": 1,
    "page_size": 50,
    "summary": null
  }
}

精确契约

相关操作

POST 发现能力 · POST 检查能力 · POST 预检能力 · POST 调用能力

这个页面对你有帮助吗?