GET /api/private/v1/plans
分页查询当前项目中的套餐列表,并附带配额配置。
字段说明
group:套餐组。相同group的套餐属于同一条续费链,同一时刻最多只有一个生效套餐。value:面值。用于同组升级时折算剩余时长;免费套餐通常为0,付费套餐应大于0。
变更约束
为避免订阅链和历史数据出现不一致,套餐创建后应遵循以下限制:
- 不允许修改
group - 不允许在免费/付费类型之间切换
- 不允许修改
value - 一旦套餐已有订阅或卡密记录,不应再删除
查询参数
| 参数 | 类型 | 说明 |
|---|---|---|
page | number | 页码 |
pageSize | number | 每页条数 |
search | string | 按套餐名称模糊搜索 |
成功响应
{
"ok": true,
"requestId": "req_123",
"data": {
"data": [
{
"id": 2,
"slug": "pro",
"name": "Pro",
"projectId": "clx_project",
"value": 100,
"group": "main",
"createdAt": "2026-03-01T00:00:00.000Z",
"updatedAt": "2026-03-01T00:00:00.000Z",
"quotas": [
{
"id": 8,
"planId": 2,
"featureId": 5,
"limit": 1000,
"priority": 0,
"resetInterval": "P1M",
"createdAt": "2026-03-01T00:00:00.000Z",
"updatedAt": "2026-03-01T00:00:00.000Z",
"feature": {
"id": 5,
"slug": "api-calls",
"name": "API Calls",
"description": "Monthly API calls",
"projectId": "clx_project",
"metered": true,
"unit": "count",
"createdAt": "2026-03-01T00:00:00.000Z",
"updatedAt": "2026-03-01T00:00:00.000Z"
}
}
]
}
],
"total": 1,
"page": 1,
"pageSize": 10,
"totalPages": 1
}
}