GET/api/v1/admin/recharge/catalog
管理员Cookie、HTTPS、JWE、ADMIN_RECHARGE_READJSON 响应接入指南 ↗

读取充值配置目录

请求参数

后台公共头固定admin/web/admin_web,独立管理员Cookie;App Bearer不能替代。OWNER拥有ADMIN_RECHARGE_READ和ADMIN_RECHARGE_WRITE,VIEWER只有ADMIN_RECHARGE_READ。写请求还必须同源Origin及X-Admin-CSRF。

无业务参数。

所有请求必须携带 Accept-Language 和八项公共头:X-Client-Type、X-Platform、X-App-Version、X-App-Build、X-Channel、X-Device-Id、X-Request-Id、X-Request-Timestamp。安装ID持久化、请求ID每次新建、时间戳为当前Unix毫秒。正式HTTPS与AES/JWE必需;GET使用X-Budyoo-JWE、PUT使用application/jose。以下展示加密前/解密后的业务内容,不是明文生产请求。

请求示例

示例客户端准备的完整请求头(实际凭据与JWE由统一传输层生成,示例值不应复用):

Accept-Language: zh-CN
X-Client-Type: admin
X-Platform: web
X-App-Version: 1.0.0
X-App-Build: 1
X-Channel: admin_web
X-Device-Id: 00000000-0000-4000-8000-000000000001
X-Request-Id: 00000000-0000-4000-8000-000000000002
X-Request-Timestamp: <发送时的13位Unix毫秒>
Cookie: <浏览器自动携带的管理员会话>
X-Budyoo-JWE: <本请求GET信封>

GET /api/v1/admin/recharge/catalog,无业务正文。

成功响应

HTTP200,标准外层code=SUCCESS、message为本地化提示、data如下、errors=[],Cache-Control:no-store。

data包含:

字段 类型 说明
platforms string[] android、ios
countries object[] 249个国家名称目录,按公共目录顺序;实际可配置范围取channels[].countryCodes
countries[].id/name/names/flagUrl string/string/object/string 小写代码、当前语言名称、zh-CN/en/ja/ko名称、本站国旗路径
currencies object[] 服务端支持且小数精度为0–4的ISO币种
currencies[].code/scale string/integer 大写三位币种与小数位
maxPackages integer 每组最多20档

新增channels与pricing。channels为九项,含code、platform、四语names、feePercent(国内七渠道0、Google15、Apple30)、countryCodes(该渠道可独立配置的国家代码数组)、fallbackCountry(Google与Apple为us,国内渠道为null)。Google Play仅允许us/jp/kr,App Store允许cn/us/jp/kr,国内七渠道仅允许cn(中国大陆);具体白名单见catalog的channels[].countryCodes。管理端越界国家返回400 INVALID_RECHARGE_CONFIGURATION,不自动改写为美国配置。fallbackCountry仅说明App套餐展示规则,管理端不回退;Google国家顺序为us/jp/kr,Apple为cn/us/jp/kr。pricing含baseCurrency=CNY、diamondsPerYuan=10、tiers六档整数、asOf汇率时点、sourceUrl汇率署名地址、territorySourceUrl币种来源、rates(币种到十进制字符串汇率,表示1 CNY兑换多少本币)、countryCurrencies(国家到运营计价币种)、usdFallbackCountries=[aq,kp]。快照供人民币基准报价使用,界面显示来源与日期;人工保存仍可明确调整币种和售价。

失败响应

HTTP code 条件
400 INVALID_RECHARGE_CONFIGURATION 平台、国家、币种、套餐范围或编号归属无效
400 BAD_REQUEST/VALIDATION_FAILED/INVALID_CLIENT_HEADERS JSON、字段类型/范围或公共头无效
400 ENCRYPTION_REQUIRED/INVALID_ENCRYPTED_REQUEST 缺少或无效JWE
401/403 UNAUTHORIZED/FORBIDDEN 会话、安装绑定或权限校验失败
426/429 HTTPS_REQUIRED/TOO_MANY_REQUESTS 传输或限流拒绝
503 SERVICE_UNAVAILABLE 数据库或Redis不可用,不解释为空套餐

code固定;message和字段错误支持中英日韩,缺省/未知语言回退英文。

接入说明

后台按Android/iOS → 国家 → 套餐管理。同平台不同国家和不同平台相互隔离,不提供全局或分组充值开关。保存只改变套餐展示,不创建订单、核验付款、增加余额或授予VIP。国家参数是显式选择,不证明真实支付市场;IP、商店国家与自动匹配均未接入。管理端不跨平台/国家回退;App商店渠道的美国展示兜底见App充值接口。

页面初始化拉取目录一次,再用渠道概况及所选国家读取配置。正式后台使用新增渠道入口,旧平台入口保留独立兼容。

2026-11-06国内范围修正后服务器clean verify共786项全部通过。充值相关14项覆盖七个国内渠道仅cn、旧海外报价保留及不可读写、混合国家初始化整批回滚、正式App越界400,以及Google三国、Apple四国和美国展示回退。真实受信HTTPS/JWE的6项只读接口检查和6项页面检查通过,实际逐个切换七个国内渠道均为中国大陆1/1、CNY及六档1:10报价;四语桌面/手机12组布局通过。当前14组/84档可运营,全库存量2241组/13446档的价格、稳定编号和版本摘要保持一致。本次业务写入为0,未安装或运行客户端设备。商店商品绑定、国家识别、订单核验和真实支付继续留到最后接入。

真实后台验收使用本站明确受信证书,JSON经真实JWE认证解密。本次仅调整可运营国家及展示回退,保留既有报价、版本和审计,不批量重写套餐。