用户套餐
当前用户套餐、用量和升级。
查询用户套餐已购买的增值项
分页查询指定用户套餐已购买的增值项。普通用户只能查看自己的用户套餐;管理员可查看任意套餐。limit=0 时不分页。
购买用户套餐增值项
为指定用户套餐购买增值项。普通用户购买时会按当前价格从账户余额扣款并创建已付款订单;若已购买同一普通增值项,则数量累加。WAF 防护增值项固定购买一份:基础套餐已包含 WAF,或当前套餐已持有任一 WAF 防护增值项时,均不能重复购买。已购买的 WAF 权益不受升级包后续上下架影响。管理员操作不执行普通用户的余额扣款流程。
调整用户套餐增值项数量
调整指定用户套餐中某个增值项的数量。若该增值项已存在,amount 必须大于 0 且小于当前数量,因此该接口用于减少数量;若不存在则创建关联。WAF 防护增值项固定为一份且不支持通过此接口调整数量。普通用户只能操作自己的套餐,管理员可操作任意套餐。
删除用户套餐增值项
删除指定用户套餐与升级包之间的关联。普通用户删除前会校验移除后流量、域名、端口等资源是否仍满足当前用量。删除 WAF 防护增值项时,普通用户和管理员都会计算删除后的有效 WAF 权限:基础套餐仍提供 WAF 时可直接删除;若这是最后一份 WAF 权益且存在已开启 WAF 的网站,则必须先关闭这些网站的 WAF。服务端校验套餐和升级包是否存在,但不单独校验两者的关联记录是否存在:关联不存在时删除语句影响 0 行,仍可能返回成功。
预估用户套餐增值项购买价格
计算指定用户套餐购买某一增值项的剩余期限价格,包含原月价、优惠后月价和按剩余天数折算的总价。WAF 防护增值项只允许预估一份;基础套餐或已购升级包已经提供有效 WAF 权限时拒绝重复预估。当前实现未在此价格查询分支中执行套餐归属校验;调用方应仅查询自己有权访问的套餐。
查询用户套餐资源用量
统计指定用户套餐当前使用的域名、主域名、非标准 HTTP/HTTPS 端口、四层转发端口和流量。默认 HTTP 80 与 HTTPS 443 端口不计入 HTTP 端口用量。
查询用户套餐列表
分页查询用户套餐及其额度、用量、节点和 CNAME 信息。普通用户只能查看自己的套餐;管理员可按 uid 筛选。limit=0 时不分页。
创建用户套餐
为当前用户购买套餐,或由管理员为指定用户创建/分配套餐。普通用户购买会校验套餐可售性、购买限制、实名要求、续费时间、优惠码和余额;管理员可覆盖套餐的部分资源、价格和节点配置。
批量更新用户套餐
更新一条或多条已有用户套餐。请求体可为对象或对象数组,且每个对象都必须提供 id;缺少 id 会直接返回业务错误,不会创建套餐。普通用户只能操作自己的套餐,管理员可设置归属用户及资源、线路、价格等受限字段。
删除指定用户套餐
删除指定用户套餐及其增值项记录。套餐所属用户可删除自己的套餐,管理员可删除任意套餐。默认不允许删除仍被网站或四层转发使用的套餐;传 force 可同时清理关联资源,但未到期且仍有网站或四层转发的套餐仍不能强制删除。
查询用户套餐详情及报价
查询指定用户套餐的完整配置、额度与有效期。套餐所属用户可查询自己的套餐,管理员可查询任意套餐。传入续费周期可同时取得续费报价;传入目标基础套餐可取得变更套餐报价。WAF 的有效权限由本接口返回的基础套餐 waf_protect 与已购增值项共同决定:任一为有效即可使用 WAF,已购 WAF 增值项会继续计入续费费用。
更新指定用户套餐
更新指定用户套餐的配置、额度、状态或有效期。套餐所属用户只能更新自己的套餐;涉及归属用户等管理员字段时需要管理员身份。更换基础套餐、续费、启停和节点组变更会按服务端规则同步相关站点或任务。更换套餐时会把已购 WAF 增值项计入目标套餐的有效 WAF 权限;目标基础套餐自带 WAF 时,允许暂时保留原 WAF 增值项,即使其绑定范围不含目标套餐,该增值项仍会计入后续续费费用。基础 waf_protect 被关闭时,只要已购 WAF 增值项仍有效,网站 WAF 不会被自动关闭。