更新 Token

生成新的 API Token，並立即使舊 Token 失效。

POST/api/token/update

驗證:API Key

速率限制:30/分鐘

請求參數

所有請求參數需透過 Query 或 Body 傳遞

參數名	類型	必填	說明
`token`	string	必填	當前 API Token，調用成功後會立即失效範例: your_api_token_here

回應參數

參數名	類型	必填	說明
`code`	number	必填	狀態碼範例: 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-TW

支援的語言

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-TW" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "token=your_api_token_here"

注意事項

調用成功後，舊 token 會立即失效，後續請求必須使用響應中的新 token
新 token 會繼承原 token 的有效期配置
接口成功後會清除舊 token 快取，避免舊 token 繼續命中快取

在控制台試一試

在下方填寫參數後直接發送請求測試。請求只發往本站 API，地址已鎖定不可修改；會攜帶你當前登入的 Cookie。

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

tokenstring必填

當前 API Token，調用成功後會立即失效