跳到主要内容

GET /api/private/v1/plans

分页查询当前项目中的套餐列表,并附带配额配置。

字段说明

  • group:套餐组。相同 group 的套餐属于同一条续费链,同一时刻最多只有一个生效套餐。
  • value:面值。用于同组升级时折算剩余时长;免费套餐通常为 0,付费套餐应大于 0

变更约束

为避免订阅链和历史数据出现不一致,套餐创建后应遵循以下限制:

  • 不允许修改 group
  • 不允许在免费/付费类型之间切换
  • 不允许修改 value
  • 一旦套餐已有订阅或卡密记录,不应再删除

查询参数

参数类型说明
pagenumber页码
pageSizenumber每页条数
searchstring按套餐名称模糊搜索

成功响应

{
"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
}
}