更新 Token

生成新的 API Token，并立即使旧 Token 失效。

POST/api/token/update

认证:API Key

限流:30/分钟

请求参数

所有请求参数需通过 Query 或 Body 传递

参数名	类型	必填	说明
`token`	string	必填	当前 API Token，调用成功后会立即失效示例: your_api_token_here

响应参数

参数名	类型	必填	说明
`code`	number	必填	状态码：1=成功，0=失败示例: 1
`msg`	string	必填	返回信息示例: 刷新成功
`data.username`	string	必填	用户名示例: testuser
`data.token`	string	必填	新的 API Token 示例: new_api_token_here
`data.expire_time`	number	必填	新 Token 继承的过期时间戳，0 表示永久有效示例: 1772267945
`data.old_token_invalidated`	boolean	必填	旧 Token 是否已失效示例: true

响应示例

{

"code":1,

"msg":"刷新成功",

"time":1769675945,

"data":

{

"username":"testuser",

"token":"new_api_token_here",

"expire_time":1772267945,

"old_token_invalidated":true

}

"ysucc":"Ysucc"

}

错误码

错误码3 个定义

0

token不能为空

未提供 token 参数

0

token不正确

Token 无效、已被替换或账号状态不可用

0

Token已过期

已过期 Token 不能用于更新 Token

响应语言

通过 X-Lang 请求头自定义接口返回语言。下方代码示例会自动使用您当前访问系统的语言。

推荐请求头

X-Lang: zh

支持的语言

zh, en, zh-TW, vi, ar

也可以使用 Accept-Language；X-Lang 优先级更高。不支持的语言将回退为英文。

代码示例

curl -X POST "https://testypro.iwai.cc,https://cer.xyul.cn,https://cer.iwai.cc/api/token/update" \
  -H "X-Lang: zh" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "token=your_api_token_here"

注意事项

调用成功后，旧 token 会立即失效，后续请求必须使用响应中的新 token
新 token 会继承原 token 的有效期配置
接口成功后会清除旧 token 缓存，避免旧 token 继续命中缓存

在控制台试一试

填好参数后直接点发送测试，接口地址固定为本站，会带上当前登录状态

POSThttps://testypro.iwai.cc/api/token/update已锁定本站

tokenstring必填

当前 API Token，调用成功后会立即失效