v1.1.4 更新说明

更新日期：2026-08-09

一句话概览

v1.1.4 为账号预检增加 ChatGPT 过期 Token 自动刷新能力：precheckAccount 成功响应新增可选字段 refreshed_token，调用方收到后必须用它替换原 token 再提交兑换。

变化级别

级别	结论	说明
接口路径	不变	仍为 `POST /api/v1/sub/precheckAccount`。
请求字段	不变	仍提交 `token`、`cdk` 和 `activation_token`。
响应字段	新增，可选	成功响应可能新增 `refreshed_token`。
服务端行为	增强	ChatGPT Access Token 过期时，服务端会尝试使用完整 Session JSON 自动刷新并重新预检。
兼容性	向后兼容	未触发刷新时响应结构和原调用流程保持不变。
缓存策略	明确	预检响应返回 `Cache-Control: no-store` 和 `Pragma: no-cache`。

变更接口

2-预检订阅账号

路径：POST /api/v1/sub/precheckAccount

本次没有修改请求字段。ChatGPT 场景仍需将完整 Session JSON 压缩为 zstd64:<base64> 后提交；Claude 场景仍提交原始 sessionKey 的压缩结果。

自动刷新流程

调用方提交完整 ChatGPT Session JSON 压缩后的 token。

服务端执行账号预检；如果 Access Token 正常，直接返回原预检结果。

如果检测到 Access Token 已过期，服务端使用 Session JSON 中的 sessionToken 刷新登录态。

刷新成功后，服务端使用新的 Access Token 重新执行账号预检。

重新预检成功时，响应返回新的 refreshed_token。

调用方使用 refreshed_token 替换原 token，再调用 redeem。

新增响应字段

字段	类型	必填	说明
`refreshed_token`	string	否	自动刷新后的登录态 token，格式为 `zstd64:<base64>`。仅 ChatGPT Access Token 过期、自动刷新成功且账号预检通过时返回。

自动刷新成功示例

{
  "code": 200,
  "error": "",
  "provider": "openai",
  "email": "user@example.com",
  "name": "YY",
  "account_id": "acct_xxx",
  "plan_type": "free",
  "subscription_plan": "",
  "has_active_subscription": false,
  "refreshed_token": "zstd64:KLUv/QBY...refreshed",
  "eligible": true
}

收到该字段后，后续请求应使用：

{
  "token": "zstd64:KLUv/QBY...refreshed",
  "cdk": "AUTO-SUB-ABCDEFGH",
  "activation_token": "7f2b4c6d8e..."
}

返回规则

场景	是否返回 `refreshed_token`	调用方处理
ChatGPT Token 正常	否	继续使用原 `token`。
ChatGPT Token 过期且自动刷新成功	是	立即替换原 `token`，后续 `redeem` 使用新值。
ChatGPT Token 过期但缺少完整 Session JSON	否	提示用户重新获取并提交完整 Session JSON。
ChatGPT 登录态刷新失败	否	展示 `error`，重新获取 Session JSON 后提交。
Claude 账号预检	否	继续使用原 Claude token。

新增或明确的失败提示

缺少自动刷新所需信息

{
  "code": 0,
  "error": "Access Token 已过期，请重新提交完整 Session JSON",
  "provider": "openai",
  "eligible": false
}

该情况通常表示提交内容只有 access token，或 Session JSON 缺少 sessionToken。

登录态刷新失败

{
  "code": 0,
  "error": "登录态刷新失败，请重新获取 Session JSON 后提交",
  "provider": "openai",
  "eligible": false
}

该情况包括刷新请求失败、刷新后缺少有效 Access Token，或刷新后的账号与原账号不一致。

安全与缓存

precheckAccount 响应包含 Cache-Control: no-store 和 Pragma: no-cache。

refreshed_token 与请求中的 token 具有相同敏感级别，不应写入日志、分析事件或错误上报。

建议只在当前兑换流程内保存刷新后的 token，并在流程结束后清理。

调用方升级建议

保持现有请求结构不变，ChatGPT 场景继续提交完整 Session JSON 的压缩结果。

预检成功后检查是否存在非空 refreshed_token。

存在时用 refreshed_token 覆盖当前 token，并将刷新后的值传给 redeem。

不存在时继续使用原 token，原有调用逻辑无需调整。

对两类新增失败提示直接展示 error，引导用户重新获取完整 Session JSON。

兼容性说明

本次变更向后兼容。refreshed_token 为可选字段，旧调用方可以忽略；但忽略该字段后，自动刷新成功的场景仍会把旧 Token 传给 redeem，导致后续兑换失败，因此建议尽快接入替换逻辑。

v1.1.4 更新说明（2026-08-09）

v1.1.4 更新说明#

一句话概览#

变化级别#

变更接口#

2-预检订阅账号#

自动刷新流程#

新增响应字段#

自动刷新成功示例#

返回规则#

新增或明确的失败提示#

缺少自动刷新所需信息#

登录态刷新失败#

安全与缓存#

调用方升级建议#

兼容性说明#