为项目创建或切换计费订阅

POST

/v1/admin/billing/subscriptions

将指定租户项目绑定至活动套餐版本；服务端校验项目归属和生效区间。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数application/json必填

示例

{
    "tenantId": "tenant_example",
    "projectId": "project_example",
    "planVersionId": "billplanv_example",
    "startsAt": "2026-09-01T00:00:00.000Z"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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

返回响应

🟢201

application/json

已创建的订阅。

Bodyapplication/json

示例

{
    "id": "id_example",
    "tenantId": "tenant_example",
    "projectId": "project_example",
    "planVersionId": "planversion_example",
    "status": "scheduled",
    "startsAt": "2026-09-27T08:00:00.000Z",
    "endsAt": "2026-09-27T08:00:00.000Z"
}

🟠400BadRequest

🟠401Unauthorized

🟠403Forbidden

🟠409Conflict

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

查询项目订阅

新增人工计费调整分录