保存指定渠道VIP准入配置¶
请求参数¶
独立管理员Cookie、可信HTTPS、真实JWE及八项公共头必填,固定admin/web/admin_web。App Bearer不能调用;X-Channel:admin_web只表示后台客户端,不是要修改的App渠道。OWNER可写,VIEWER只读,写请求必须同源Origin和X-Admin-CSRF。
| 正文字段 | 类型 | 必填 | 约束 |
|---|---|---|---|
| channel | string | 是 | 从配置列表取目标代码;九正式渠道,dev渠道仅允许非prod运行配置。不传不得视为全局更新 |
| vipGateEnabled | boolean | 是 | 仅本渠道的VIP准入开关,不发放或撤销VIP |
| expectedUpdatedAt | string(date-time) | 是 | 原样传本项updatedAt,保留完整精度;不自动替换版本后重发 |
仅修改一项,其他渠道的开关和时间版本均不改变。未知字段或旧版不带channel的全局请求拒绝。
请求示例¶
按后台统一约定使用真实JWE。下列业务内容只作为加密前/解密后的示意,GET通过X-Budyoo-JWE携带信封、没有正文;PATCH通过application/jose正文提交。Cookie由浏览器自动携带。
{
"channel": "xiaomi",
"vipGateEnabled": true,
"expectedUpdatedAt": "2026-11-05T00:00:00.123456Z"
}
成功响应¶
HTTP200、Cache-Control:no-store、外层JWE。下面只返回已保存项,页面按channel更新对应行。
{
"code": "SUCCESS",
"message": "操作成功。",
"data": {
"channel": "xiaomi",
"vipGateEnabled": true,
"updatedAt": "2026-11-05T00:00:01.123457Z"
},
"errors": []
}
返回channel、vipGateEnabled及该渠道新的updatedAt;配置修改与VIP_GATE_UPDATE成功审计同事务,审计目标channel..vipGateEnabled。409保留输入,重读后由管理员确认;网络结果不明不自动重发。
失败响应¶
| HTTP | code | 条件/处理 |
|---|---|---|
| 400 | BAD_REQUEST/VALIDATION_FAILED/INVALID_CLIENT_HEADERS | 字段、类型、元数据或必填channel/版本不合法 |
| 400 | INVALID_APP_CHANNEL | 未知渠道或prod使用dev;不回退总开关 |
| 400 | ENCRYPTION_REQUIRED/INVALID_ENCRYPTED_REQUEST | 缺真实JWE或认证失败 |
| 401/403 | UNAUTHORIZED/FORBIDDEN/ADMIN_CSRF_INVALID | 独立会话、权限、Origin或CSRF拒绝 |
| 409 | ADMIN_CONFIG_CONFLICT | 仅写入:本项并发版本已变化 |
| 426/429 | HTTPS_REQUIRED/TOO_MANY_REQUESTS | 传输或入口限流 |
| 503 | SERVICE_UNAVAILABLE | 策略缺失、数据库或Redis依赖不可用,不当作关闭门槛 |
code固定,message与字段错误中英日韩、缺省英文,沿用公共协议。
接入说明¶
App仍发送既有X-Channel,读取原vipGateEnabled/vipActive/vipRequired;字段结构不变,门槛来源改为登录会话绑定的发行渠道。注册资料未完成先完善资料;完成后仅在本渠道开关开启且账号无有效VIP时要求VIP。有效VIP权益仍按账号跨渠道统一,关闭开关不赠送会员。
V28把旧全局值及时间版本复制到九个正式渠道及dev,各项随后独立维护;旧app_access_policy保留为历史来源,不再参与运行时判断。注册渠道是首次归因,不是当前会话门槛来源。未知渠道或平台不匹配明确400;旧NULL会话首次合法访问/刷新时原子绑定一次,后续请求或刷新改渠道返回401,需要重新登录。
真实支付下单、凭证核验与权益发放尚未接入;本接口只设置准入规则。客户端渠道声明和绑定不能证明真实商店安装;prod的dev标识禁止使用。2026-11-06配套API与新后台页面已发布;585项服务器回归与28项真实入口只读检查通过,线上未切换门槛或新增App测试账号。实际验证范围见共享VIP准入。