A AuthMS API Wiki API Reference iam.tianv.com →

POST /billing/subscribe

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

计费服务 `bearerAuth` application/json

Request Body

Schema: dto.SubscribeRequestDTO

FieldTypeRequiredExampleConstraintsDescription
billing_cycle string Yes monthly
plan string Yes pro
auto_renew boolean No True
trial_days integer No 14

Responses

StatusDescriptionSchema
201订阅创建成功dto.SubscriptionDetailResponse
400请求参数错误object
401未授权object
409租户已有有效订阅object
500服务器内部错误object

Referenced Schemas

dto.SubscriptionDetailResponse

FieldTypeRequiredExampleConstraintsDescription
code integer No
data dto.SubscriptionResponse No
message string No
timestamp string No

dto.SubscriptionResponse

FieldTypeRequiredExampleConstraintsDescription
admin_user_id string No usr_abc123
amount number No 499
auto_renew boolean No True
billing_cycle string No monthly
cancel_at_period_end boolean No False
currency string No CNY
current_period_end string No 2026-02-01T00:00:00Z
current_period_start string No 2026-01-01T00:00:00Z
grace_period_days integer No 7
plan_id string No pro
status string No active
tenant_id string No tnt_xyz789
trial_end_date string No 2026-01-15T00:00:00Z