读取各渠道VIP准入配置¶
请求参数¶
独立管理员Cookie、可信HTTPS、真实JWE及八项公共头必填,固定admin/web/admin_web。App Bearer不能调用;X-Channel:admin_web只表示后台客户端,不是要修改的App渠道。OWNER可写,VIEWER只读,写请求必须同源Origin和X-Admin-CSRF。
无查询参数或业务正文。返回九个正式渠道;仅dev且非prod额外返回开发联调dev(region=development、platform=any),prod不暴露或允许该项。名称按Accept-Language,未知语言回退英文,代码和策略不翻译。
请求示例¶
按后台统一约定使用真实JWE。下列业务内容只作为加密前/解密后的示意,GET通过X-Budyoo-JWE携带信封、没有正文;PATCH通过application/jose正文提交。Cookie由浏览器自动携带。
GET /api/v1/admin/configuration,无业务正文。
成功响应¶
HTTP200、Cache-Control:no-store、外层JWE。下面仅截取一项,实际返回完整渠道列表。
{
"code": "SUCCESS",
"message": "操作成功。",
"data": {
"channels": [
{
"channel": "xiaomi",
"name": "小米",
"names": {
"zh-CN": "小米",
"en": "Xiaomi",
"ja": "Xiaomi",
"ko": "샤오미"
},
"region": "domestic",
"platform": "android",
"vipGateEnabled": false,
"updatedAt": "2026-11-05T00:00:00.123456Z"
}
]
},
"errors": []
}
| data字段 | 类型/可空 | 说明 |
|---|---|---|
| channels | object[],非空 | 按共享发行清单顺序排列,dev在允许环境置最后 |
| channels[].channel | string,非空 | 不可编辑的渠道代码 |
| channels[].name/names | string/object,非空 | 当前界面名称及中英日韩名称 |
| channels[].region | string,非空 | domestic/overseas/global;dev为development,只用于发行分类展示 |
| channels[].platform | string,非空 | android/ios;dev为any,但App实际请求仍只能android或ios |
| channels[].vipGateEnabled | boolean,非空 | 该渠道独立准入开关 |
| channels[].updatedAt | date-time,非空 | 该渠道精确并发版本 |
失败响应¶
| HTTP | code | 条件/处理 |
|---|---|---|
| 400 | BAD_REQUEST/INVALID_CLIENT_HEADERS | 查询格式或公共元数据不合法 |
| 400 | ENCRYPTION_REQUIRED/INVALID_ENCRYPTED_REQUEST | 缺真实JWE或认证失败 |
| 401/403 | UNAUTHORIZED/FORBIDDEN/ADMIN_CSRF_INVALID | 独立会话、权限、Origin或CSRF拒绝 |
| 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准入。