用户套餐
当前用户套餐、用量和升级。
查询套餐升级选项
分页查询指定用户套餐已购买的升级包。普通用户只能查询自己的用户套餐;管理员可查询任意用户套餐。结果按升级记录 ID 倒序返回。
创建套餐升级
为指定用户套餐购买或增加升级包数量。请求体必须是对象。普通用户只能操作自己的套餐:系统会校验升级包是否绑定当前基础套餐、套餐剩余时间不少于一天,并按剩余天数、可用折扣和数量计算价格后从账户余额扣款,同时创建已付款订单。管理员操作时不执行该余额扣款流程。
更新套餐升级
调整指定用户套餐中已购买升级包的数量。请求体必须为对象。普通用户仅能操作自己的套餐,且只能把已存在升级包的数量减少到大于 0 且小于当前数量的值;减少后系统会校验流量、域名、端口及自定义 CC 规则等已用资源是否仍有足够额度。管理员不受普通用户的资源减少限制。
删除套餐升级
从指定用户套餐移除一个升级包。普通用户只能操作自己的套餐;删除前会检查移除后流量、域名、主域名、HTTP/转发端口和自定义 CC 规则等已用资源是否仍有足够额度。管理员不执行该普通用户资源余量检查。
获取套餐升级详情
试算指定用户套餐购买升级包的价格。服务端按套餐剩余天数、当前用户组适用折扣和请求数量计算原月价、折后月价、原价及实付价;套餐已过期或剩余不足一天时不能试算。
查询套餐用量
查询指定用户套餐当前已使用的域名、主域名、HTTP 非标准端口、四层转发端口和流量。普通用户只能查询自己的套餐;管理员可查询任意用户套餐。
查询用户套餐
分页查询用户已购买的基础套餐。普通用户只能查询自己的套餐;管理员可按用户、套餐、到期时间、CNAME、流量超额和启用状态筛选。默认按 ID 倒序,可按到期时间升序。
创建用户套餐
购买并创建一个用户套餐。普通用户为自己购买时会校验套餐可购资格、购买次数、实名认证、套餐状态,并按 `duration`、可用折扣和优惠码计算价格后扣除余额、创建订单;管理员可为指定用户分配套餐,并可覆盖套餐资源额度与价格。
删除指定用户套餐
删除一个用户套餐及其已购买的升级包。普通用户只能删除自己的套餐。默认删除模式要求套餐没有关联网站和四层转发;传入 `force` 会同时删除关联网站、四层转发及其部分关联数据,但仍不允许删除未到期且存在网站或四层转发的套餐。若这是该用户唯一套餐,强制删除还会删除该用户的证书、DNS API、访问控制、CC 规则、分组、任务和消息发送配置。
获取用户套餐详情
获取用户套餐详情。可选传入 `duration` 试算续费价格,或传入 `to_package` 试算更换至另一基础套餐的差价;可同时传入优惠码参与续费价格计算。普通用户只能查看自己的套餐,管理员可查看任意套餐。
更新指定用户套餐
更新一个已购买套餐的名称、线路、CNAME、资源额度、开关或到期时间,也可通过 `duration` 为套餐续费。普通用户只能更新自己的套餐中无需管理员权限的字段;资源额度、价格、CNAME 主机名、到期时间及启用状态仅管理员可改。传入 `package` 时执行更换基础套餐并立即完成,不能与其他修改字段组合处理。