读取渠道充值概况¶
请求参数¶
请求沿用公共协议、公共请求头和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读取。
成功响应¶
data为数组,按country排序,仅包含当前运营国家中已保存过的配置,范围外旧记录不返回;无配置时[]。清空套餐仍保留版本和一行概况。
| 字段 | 类型 | 说明 |
|---|---|---|
| country | string | 小写两位国家代码 |
| currency | string | 本组币种 |
| version | integer | 当前独立版本 |
| packageCount | integer | 当前档数,0表示主动清空 |
| updatedAt | ISO时间 | 最近成功保存时间 |
{
"code": "SUCCESS",
"message": "操作成功",
"data": [
{
"country": "us",
"currency": "USD",
"version": 1,
"packageCount": 6,
"updatedAt": "2026-11-06T08:00:00Z"
}
],
"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,未安装或运行客户端设备。商店商品绑定、国家识别、订单核验和真实支付继续留到最后接入。