生成并封存项目账单

POST

/v1/admin/billing/statements

对指定半开时间区间的用量和分录生成不可变快照；相同项目和区间重复请求返回原账单。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json必填

示例

{
    "tenantId": "tenant_example",
    "projectId": "project_example",
    "from": "2026-09-01T00:00:00.000Z",
    "to": "2026-10-01T00:00:00.000Z"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/admin/billing/statements' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "tenantId": "tenant_example",
    "projectId": "project_example",
    "from": "2026-09-01T00:00:00.000Z",
    "to": "2026-10-01T00:00:00.000Z"
}'

返回响应

🟢201

application/json

已封存的账单快照。

Bodyapplication/json

示例

{
    "id": "id_example",
    "tenantId": "tenant_example",
    "projectId": "project_example",
    "periodStart": "2026-09-27T08:00:00.000Z",
    "periodEnd": "2026-09-27T08:00:00.000Z",
    "status": "open",
    "currency": "示例值",
    "acceptedTurns": 0,
    "grossAmountMinor": 1,
    "adjustmentAmountMinor": 1,
    "totalAmountMinor": 1,
    "usageCount": 0,
    "entryCount": 0,
    "generatedAt": "2026-09-27T08:00:00.000Z",
    "finalizedAt": "2026-09-27T08:00:00.000Z",
    "requestId": "request_example"
}

🟠400BadRequest

🟠401Unauthorized

🟠403Forbidden

🟠409Conflict

修改于 2026-09-27 15:11:45

冲正计费分录

检查网关健康状态