POST `/billing/subscribe`

为当前租户创建订阅，绑定套餐（free/basic/pro/enterprise/platform）和计费周期（monthly/yearly）。支持设定自动续费和试用天数。

计费服务 `bearerAuth` application/json

请求体

Schema： service-billing/internal/handler/dto.SubscribeRequestDTO

字段	类型	必填	示例	约束	描述
`billing_cycle`	`string`	是	`monthly`
`plan`	`string`	是	`pro`
`auto_renew`	`boolean`	否	`True`
`trial_days`	`integer`	否	`14`

响应

状态	描述	Schema
201	订阅创建成功	`service-billing/internal/handler/dto.SubscriptionDetailResponse`
400	请求参数错误	`object`
401	未授权	`object`
409	租户已有有效订阅	`object`
500	服务器内部错误	`object`

引用的 Schema

service-billing/internal/handler/dto.SubscriptionDetailResponse

字段	类型	必填	示例	约束	描述
`code`	`integer`	否
`data`	`service-billing/internal/handler/dto.SubscriptionResponse`	否
`message`	`string`	否
`timestamp`	`string`	否

service-billing/internal/handler/dto.SubscriptionResponse

字段	类型	必填	示例	约束	描述
`admin_user_id`	`string`	否	`usr_abc123`
`amount`	`number`	否	`499`
`auto_renew`	`boolean`	否	`True`
`billing_cycle`	`string`	否	`monthly`
`cancel_at_period_end`	`boolean`	否	`False`
`currency`	`string`	否	`CNY`
`current_period_end`	`string`	否	`2026-02-01T00:00:00Z`
`current_period_start`	`string`	否	`2026-01-01T00:00:00Z`
`grace_period_days`	`integer`	否	`7`
`plan_id`	`string`	否	`pro`
`status`	`string`	否	`active`
`tenant_id`	`string`	否	`tnt_xyz789`
`trial_end_date`	`string`	否	`2026-01-15T00:00:00Z`

在 Scalar 中试用此 API → 下载 OpenAPI 规范（JSON）↓