版本 2.1.1792967583 · 最新下载 OpenAPI Markdown 版

升级包

在基础套餐之上按份加购的额度或功能。

package-upgrades套餐鉴权: 仅管理员5 个接口

列出升级包

GET/api/v2/package-upgrades

鉴权: 仅管理员

查询参数

字段	类型	必填	说明
page	integer	—	页码,从 1 开始。默认 `1`
page_size	integer	—	每页条数。默认 `20`
sort	string	—	排序字段,逗号分隔,前缀 `-` 表示降序,如 `-created_at,id`。

创建升级包

POST/api/v2/package-upgrades

鉴权: 仅管理员

请求体 application/json

字段	类型	必填	说明
amount	integer	—	每份加多少;功能类(custom_cc_rule/websocket)恒为 1
bind_packages	integer[]	—	只许这些基础套餐加购;空 = 不限
des	string	—	备注说明
enabled	boolean	—	是否启用
name	string	必填	名称
price_cents	integer	必填	每份每月价格,分
type	string	必填	加购项:流量 GB、域名数、非标端口数、四层端口数、自定义 CC、带宽 Mbps、连接数、WebSocket、独立 IP 数可选值 `["traffic","domain","http_port","stream_port","custom_cc_rule","bandwidth","connection","websocket","ip_num"]`

获取升级包

GET/api/v2/package-upgrades/{id}

鉴权: 仅管理员

修改升级包

PUT/api/v2/package-upgrades/{id}

鉴权: 仅管理员

请求体 application/json

字段	类型	必填	说明
amount	integer	—	每份加多少;功能类(custom_cc_rule/websocket)恒为 1
bind_packages	integer[]	—	只许这些基础套餐加购;空 = 不限
des	string	—	备注说明
enabled	boolean	—	是否启用
name	string	必填	名称
price_cents	integer	必填	每份每月价格,分
type	string	必填	加购项:流量 GB、域名数、非标端口数、四层端口数、自定义 CC、带宽 Mbps、连接数、WebSocket、独立 IP 数可选值 `["traffic","domain","http_port","stream_port","custom_cc_rule","bandwidth","connection","websocket","ip_num"]`

删除升级包

DELETE/api/v2/package-upgrades/{id}

鉴权: 仅管理员

升级包对象

字段	类型	必填	说明
amount	integer	—	每份加多少;功能类(custom_cc_rule/websocket)恒为 1
bind_packages	integer[]	—	只许这些基础套餐加购;空 = 不限
created_at	string	—	创建时间只读
des	string	—	备注说明
enabled	boolean	—	是否启用
id	integer	—	记录 ID 只读
name	string	—	名称
price_cents	integer	—	每份每月价格,分
type	string	—	加购项:流量 GB、域名数、非标端口数、四层端口数、自定义 CC、带宽 Mbps、连接数、WebSocket、独立 IP 数可选值 `["traffic","domain","http_port","stream_port","custom_cc_rule","bandwidth","connection","websocket","ip_num"]`
updated_at	string	—	更新时间只读

curl

# 列出升级包
curl "https://panel.example.com/api/v2/package-upgrades" \
  -H "X-API-Key: $GOCDN_API_KEY"

# 创建升级包
curl -X POST "https://panel.example.com/api/v2/package-upgrades" \
  -H "X-API-Key: $GOCDN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount":10,"name":"域名 +10","price_cents":1000,"type":"domain"}'

# 获取升级包
curl "https://panel.example.com/api/v2/package-upgrades/{id}" \
  -H "X-API-Key: $GOCDN_API_KEY"

# 修改升级包
curl -X PUT "https://panel.example.com/api/v2/package-upgrades/{id}" \
  -H "X-API-Key: $GOCDN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount":10,"name":"域名 +10","price_cents":1000,"type":"domain"}'

# 删除升级包
curl -X DELETE "https://panel.example.com/api/v2/package-upgrades/{id}" \
  -H "X-API-Key: $GOCDN_API_KEY"