API 参考 / admin

待人工结案的配额预占（平台超管）

GET /api/v1/admin/quota-reconciliations · adminListQuotaReconciliations

返回终态生成任务仍为 reserved，或重分析处于 generation_unknown 的悬空预占。活跃任务的正常预占不进入列表。要求平台超管，项目级 API Token 不可访问。

本接口要求浏览器会话。Bearer API Token 无法调用——Token 的生命周期管理必须在网页端完成。

响应字段 · 200

items（必填）: AdminQuotaReconciliationCase[]
items[].ledgerEntryId（必填）: string
items[].orgId（必填）: string
items[].orgName（必填）: string
items[].amount（必填）: integer
items[].draftId（必填）: string
items[].jobId（必填）: string
items[].generationJobStatus（必填）: string
items[].reanalysisRunId（必填）: string
items[].reanalysisStatus（必填）: string
items[].projectId（必填）: string
items[].createdAt（必填）: string

错误

401：Problem 错误响应
403：Problem 错误响应

请求示例（curl）

curl -X GET "https://你的项目.workflow.games/api/v1/admin/quota-reconciliations" \
  -H "Authorization: Bearer wfp_…"

响应示例

HTTP/1.1 200
{
  "items": [
    {
      "ledgerEntryId": "018f3c2e-0000-7000-8000-000000000000",
      "orgId": "018f3c2e-0000-7000-8000-000000000000",
      "orgName": "示例标题",
      "amount": 1,
      "draftId": "018f3c2e-0000-7000-8000-000000000000",
      "jobId": "018f3c2e-0000-7000-8000-000000000000",
      "generationJobStatus": "示例文本",
      "reanalysisRunId": "018f3c2e-0000-7000-8000-000000000000",
      "reanalysisStatus": "示例文本",
      "projectId": "018f3c2e-0000-7000-8000-000000000000",
      "createdAt": "示例文本"
    }
  ]
}

合同真值：OpenAPI 3.1（0.1.0）。

相关：Agent 接入指南 · 使用指南 · API 参考索引