TokenRefreshInfo

@Serializable
data class TokenRefreshInfo(val mode: String, val refreshWindowSeconds: Int, val previousTokenSecondsRemaining: Int)

令牌刷新信息 包含签名换新策略的相关信息

官方文档:vds-docs/基础接口/签名换新.md

字段说明:

  • mode: 刷新模式

  • 描述当前刷新的方式

  • 如 "exchange_current_access_token" 表示使用当前 access_token 交换

  • refreshWindowSeconds: 刷新窗口时间(秒)

  • 表示在令牌过期前多少秒进行刷新

  • 通常为 300 秒(5 分钟)

  • 当剩余时间 <= 此值时触发刷新

  • previousTokenSecondsRemaining: 旧令牌剩余有效期(秒)

  • 刷新时旧令牌还剩多少秒过期

  • 用于诊断和日志记录

响应示例:

{
"refresh": {
"mode": "exchange_current_access_token",
"refreshWindowSeconds": 300,
"previousTokenSecondsRemaining": 221
}
}

刷新规则:

  • 当剩余有效期 <= 300 秒时可以刷新

  • 刷新成功后获得新的 accessToken 和 apiKey

  • 新令牌的有效期重新计算(通常 3600 秒)

Constructors

Link copied to clipboard
constructor(mode: String, refreshWindowSeconds: Int, previousTokenSecondsRemaining: Int)

Properties

Link copied to clipboard
@SerialName(value = "mode")
val mode: String

刷新模式

Link copied to clipboard
@SerialName(value = "previousTokenSecondsRemaining")
val previousTokenSecondsRemaining: Int

旧令牌剩余有效期(秒)

Link copied to clipboard
@SerialName(value = "refreshWindowSeconds")
val refreshWindowSeconds: Int

刷新窗口时间(秒),表示在令牌过期前多少秒进行刷新