修改 Token 有效期

修改當前 API Token 的有效期時間戳。expire_time 傳 0 表示永久有效。

POST/api/token/expire

驗證:API Key

速率限制:60/分鐘

請求參數

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

參數名	類型	必填	說明
`token`	string	必填	當前 API Token 範例: your_api_token_here
`expire_time`	number	必填	新的過期時間戳，支援 Unix 秒或毫秒；傳 0 表示永久有效範例: 1772267945

回應參數

參數名	類型	必填	說明
`code`	number	必填	狀態碼範例: 1
`msg`	string	必填	返回訊息範例: 设置已保存
`data.username`	string	必填	用戶名範例: testuser
`data.expire_time`	number	必填	新的過期時間戳，0 表示永久有效範例: 1772267945
`data.status`	string	必填	狀態：permanent 或 valid 範例: valid
`data.is_valid`	boolean	必填	Token 是否有效範例: true
`data.remaining_seconds`	number	必填	剩餘有效秒數，永久有效時為 -1 範例: 2592000

回應示例

{

"code":1,

"msg":"設置已保存",

"time":1769675945,

"data":

{

"username":"testuser",

"expire_time":1772267945,

"status":"valid",

"status_text":"有效",

"is_valid":true,

"remaining_seconds":2592000,

"remaining_days":30,

"expire_time_formatted":"2026-02-28 15:04:05"

}

"ysucc":"Ysucc"

}

錯誤碼

錯誤碼3 個定義

0

token不能為空

未提供 token 參數

0

失效時間不能為空

未提供 expire_time 或格式不正確

0

失效時間必須是未來時間

expire_time 不是 0 且早於當前時間

回應語言

透過 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/expire" \
  -H "X-Lang: zh-TW" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "token=your_api_token_here&expire_time=1772267945"

注意事項

該接口會校驗當前 token 是否有效，已過期 token 不能用於修改有效期
expire_time 支援秒級或毫秒級時間戳，傳 0 可設置為永久有效
修改成功後會清除舊 token 快取，後續請求立即按新有效期校驗

在控制台試一試

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

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

tokenstring必填

當前 API Token

expire_timenumber必填

新的過期時間戳，支援 Unix 秒或毫秒；傳 0 表示永久有效