读取渠道国家套餐¶
请求参数¶
请求沿用公共协议、公共请求头和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,未安装或运行客户端设备。商店商品绑定、国家识别、订单核验和真实支付继续留到最后接入。