Token Refresh Info
@Serializable
令牌刷新信息 包含签名换新策略的相关信息
官方文档:vds-docs/基础接口/签名换新.md
字段说明:
mode: 刷新模式
描述当前刷新的方式
如 "exchange_current_access_token" 表示使用当前 access_token 交换
refreshWindowSeconds: 刷新窗口时间(秒)
表示在令牌过期前多少秒进行刷新
通常为 300 秒(5 分钟)
当剩余时间 <= 此值时触发刷新
previousTokenSecondsRemaining: 旧令牌剩余有效期(秒)
刷新时旧令牌还剩多少秒过期
用于诊断和日志记录
响应示例:
{
"refresh": {
"mode": "exchange_current_access_token",
"refreshWindowSeconds": 300,
"previousTokenSecondsRemaining": 221
}
}Content copied to clipboard
刷新规则:
当剩余有效期 <= 300 秒时可以刷新
刷新成功后获得新的 accessToken 和 apiKey
新令牌的有效期重新计算(通常 3600 秒)