GET/api/v1/admin/recharge/channels/{channel}/{country}
管理员Cookie、HTTPS、JWE、ADMIN_RECHARGE_READJSON 响应接入指南 ↗

读取渠道国家套餐

请求参数

请求沿用公共协议、公共请求头和AES/JWE。全部八项客户端头及Accept-Language必填,admin/web/admin_web固定,安装ID绑定管理员Cookie。GET信封放X-Budyoo-JWE,写请求Content-Type为application/jose;下例表示加密前与解密后的业务内容。

channel接受xiaomi、vivo、huawei、oppo、yingyongbao、honor、baidu、google_play、app_store,dev和未知代码拒绝。国家使用目录中的小写两位代码。Google Play仅允许us/jp/kr,App Store允许cn/us/jp/kr,国内七渠道仅允许cn(中国大陆);具体白名单见catalog的channels[].countryCodes。管理端越界国家返回400 INVALID_RECHARGE_CONFIGURATION,不自动改写为美国配置。没有分页或额外查询参数。

OWNER与VIEWER均可读取,只需ADMIN_RECHARGE_READ。零版本返回空组,不使用其他渠道或国家报价。

请求示例

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: <浏览器自动携带的管理员Cookie>
Origin: <本站受信HTTPS Origin>
X-Admin-CSRF: <当前会话内存中的CSRF令牌,写请求必需>

无请求体。以GET /api/v1/admin/recharge/channels/google_play/us读取。

成功响应

字段 类型 说明
channel/platform/country string 精确发行渠道、由目录确定的平台、小写国家代码
currency string或null ISO币种,零版本未配置时null
currencyScale integer 最小单位精度0–4,未配置为0
version integer 本渠道国家独立版本,未配置为0,保存成功递增
updatedAt ISO时间或null 最近成功保存时间,未配置为null
packages object[] 按sortOrder、id稳定排序,最多20档
packages[].id UUID string 服务端生成的稳定编号
packages[].diamonds integer 1–1000000000,同组唯一
packages[].priceMinor integer 本币最小单位1–1000000000000,覆盖高面额币种
packages[].sortOrder integer 0–100000,越小越靠前
{
  "code": "SUCCESS",
  "message": "操作成功",
  "data": {
    "channel": "google_play",
    "platform": "android",
    "country": "us",
    "currency": "USD",
    "currencyScale": 2,
    "version": 1,
    "updatedAt": "2026-11-06T08:00:00Z",
    "packages": [
      {
        "id": "00000000-0000-4000-8000-000000000010",
        "diamonds": 100,
        "priceMinor": 177,
        "sortOrder": 0
      }
    ]
  },
  "errors": []
}

失败响应

HTTP200使用code/message/data/errors外层结构,Cache-Control为no-store。错误同样经JWE认证。

HTTP code 条件
400 INVALID_APP_CHANNEL 渠道未知或不是正式九渠道
400 INVALID_RECHARGE_CONFIGURATION 国家不属于渠道运营范围,或币种、金额、版本、套餐编号、重复项无效
400 BAD_REQUEST/VALIDATION_FAILED/INVALID_CLIENT_HEADERS JSON类型、额外字段、范围或公共头无效
400 ENCRYPTION_REQUIRED/INVALID_ENCRYPTED_REQUEST 缺少或无效JWE
401/403 UNAUTHORIZED/FORBIDDEN/ADMIN_CSRF_INVALID 管理员身份、权限、同源或CSRF不满足
409 RECHARGE_CONFIGURATION_CONFLICT 当前版本已变更,保留输入并重新读取核对
426/429 HTTPS_REQUIRED/TOO_MANY_REQUESTS HTTPS或限流拒绝
503 SERVICE_UNAVAILABLE 数据库、审计或Redis故障,不能视为空配置

失败示例的解密结果为{"code":"RECHARGE_CONFIGURATION_CONFLICT","message":"充值配置已变更,请读取最新版本后再保存。","data":null,"errors":[]}。code固定,message和字段错误支持中英日韩,未知语言回退英文。

接入说明

后台目录同时返回channels和pricing供界面展示。汇率为2026-11-06的固定快照,页面标明时点与来源;国家币种参考Unicode CLDR 49,南极洲无统一法币、朝鲜KPW缺少本次汇率报价,两项按已确认的USD报价并明确提示。批量定价只在明确初始化时计算,汇率变化不会自动改价。

原平台国家GET/PUT继续独立兼容。正式App按服务端会话绑定渠道读取,价格不靠IP、资料国家或客户端临时付款声明决定。此处只保存报价与展示,真实商店商品、订单、支付、退款和到账仍待接入。

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,未安装或运行客户端设备。商店商品绑定、国家识别、订单核验和真实支付继续留到最后接入。