GET/api/v1/admin/configuration
管理员Cookie、HTTPS、JWE、ADMIN_CONFIG_READJSON 响应接入指南 ↗

读取各渠道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准入。