优惠与折扣
优惠码、折扣和使用记录。
查询优惠码列表
分页查询优惠码管理记录，按 ID 倒序返回。该接口需要登录且仅管理员可调用；不提供额外筛选条件。limit=0 时不执行 SQL 分页限制并返回全部记录。
创建优惠码
创建可用于基础套餐或流量包订单的优惠码。名称和兑换字符必须全局唯一；coupon_type 为 discount 时必须提供 discount_value，为 price 时必须提供 price_value。该接口需要登录且仅管理员可调用。
删除一个或多个优惠码
按路径中的优惠码 ID 删除记录。路由使用字符串参数，支持以英文逗号传入多个 ID；服务端逐个确认记录存在，任一记录不存在时返回 coupon-1 并回滚本次删除。该接口需要登录且仅管理员可调用。
获取优惠码详情
按优惠码 ID 读取完整数据库记录。该接口需要登录且仅管理员可调用；不存在的优惠码返回 coupon-2 业务错误。
更新优惠码
更新指定优惠码的已提交字段；路径 coupon_id 会覆盖请求体中的 id。所有业务字段均可选，未提交的字段保持原值，但请求必须实际改变至少一个字段，否则返回 coupon-29。coupon_type 与 discount_value、price_value 的组合仍须满足对应优惠方式的校验。该接口需要登录且仅管理员可调用。
查询折扣列表
分页查询全局折扣规则，按 priority 升序返回。该接口需要登录且仅管理员可调用；不支持额外筛选。limit=0 时取消 SQL 分页限制并返回全部记录。
创建折扣规则
创建按用户分组、套餐类别和有效时间生效的折扣规则。dis_type=discount 时必须提供 discount_value；dis_type=price 时必须同时提供 month_price、quarter_price、year_price。该接口需要登录且仅管理员可调用。
删除一个或多个折扣规则
按路径中的折扣规则 ID 删除记录。路由使用字符串参数，支持以英文逗号传入多个 ID；服务端逐个确认记录存在，任一记录不存在时返回 discount-1 并回滚本次删除。该接口需要登录且仅管理员可调用。
获取折扣规则详情
按折扣规则 ID 读取 discount 表完整记录。该接口需要登录且仅管理员可调用；不存在的记录返回 discount-2 业务错误。
更新折扣规则
更新指定折扣规则的已提交字段；路径 discount_id 会覆盖请求体中的 id。所有业务字段均可选，未提交字段保持原值，但请求必须实际改变至少一个字段，否则返回 discount-32。更新后的 dis_type 仍决定折扣值或月/季/年价格的必填组合。该接口需要登录且仅管理员可调用。