GET
v1.0.0stable查詢 Token 有效期
查詢 API Token 的有效期與有效狀態
GET
/api/token/expire驗證:API Key
速率限制:120/分鐘
請求參數
所有請求參數需透過 Query 或 Body 傳遞
| 參數名 | 類型 | 必填 | 說明 |
|---|---|---|---|
token | string | 必填 | 用戶 API Token 範例: your_api_token_here |
回應參數
| 參數名 | 類型 | 必填 | 說明 |
|---|---|---|---|
code | number | 必填 | 狀態碼：1=成功，0=失敗 範例: 1 |
msg | string | 必填 | 返回訊息 範例: 查询成功 |
time | number | 必填 | 伺服器時間戳（Unix 秒） 範例: 1769675945 |
data | object | 必填 | 業務數據 |
data.username | string | 必填 | 用戶名 範例: testuser |
data.expire_time | number | 必填 | 過期時間戳（Unix 秒），0 表示永久有效 範例: 1769675945 |
data.status | string | 必填 | 狀態：permanent=永久有效，valid=有效，expired=已過期 範例: valid |
data.status_text | string | 必填 | 狀態描述文本 範例: 有效 |
data.is_valid | boolean | 必填 | Token 是否有效 範例: true |
data.remaining_seconds | number | 必填 | 剩餘有效秒數（-1 表示永久有效） 範例: 2592000 |
data.remaining_days | number | 必填 | 剩餘有效天數（-1 表示永久有效） 範例: 30 |
data.expire_time_formatted | string | 必填 | 格式化的過期時間（永久有效時不返回） 範例: 2026-02-28 15:04:05 |
ysucc | string | 必填 | 成功標識，成功時返回 "Ysucc" 範例: Ysucc |
回應示例
{}
"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"
永久有效
Token 未設定有效期時返回永久有效
永久有效
{}
"code":1,
"msg":"查詢成功",
"time":1769675945,
"data":
{}
,"username":"testuser",
"expire_time":0,
"status":"permanent",
"status_text":"永久有效",
"is_valid":true,
"remaining_seconds":-1,
"remaining_days":-1
"ysucc":"Ysucc"
Token 已過期
Token 已超過有效期
Token 已過期
{}
"code":1,
"msg":"查詢成功",
"time":1769675945,
"data":
{}
,"username":"testuser",
"expire_time":1769000000,
"status":"expired",
"status_text":"已过期",
"is_valid":false,
"expired_seconds":675945,
"expired_days":7,
"expire_time_formatted":"2026-01-21 12:26:40"
"ysucc":"Ysucc"
錯誤碼
錯誤碼3 個定義
0token不能為空
未提供 Token 參數
0token不正確
Token 無效或已被替換
0僅支持GET請求
使用了非 GET 方法
回應語言
透過 X-Lang 請求標頭自訂介面回應語言。下方程式碼示例會自動使用您目前瀏覽系統的語言。
建議請求標頭
X-Lang: zh-TW支援的語言
zh, en, zh-TW, vi, ar也可以使用 Accept-Language；X-Lang 優先級更高。不支援的語言將回退為英文。
程式碼示例
curl -X GET "https://testypro.iwai.cc,https://cer.xyul.cn,https://cer.iwai.cc/api/token/expire?token=your_api_token_here" \
-H "X-Lang: zh-TW"注意事項
- expire_time 為 0 時表示 Token 永久有效
- remaining_seconds/remaining_days 為 -1 時表示永久有效
- 已過期的 Token 仍可查詢有效期，但 is_valid 為 false
- 已被替換的 Token 無法查詢，會返回 token 不正確
在控制台試一試
在下方填寫參數後直接發送請求測試。請求只發往本站 API，地址已鎖定不可修改；會攜帶你當前登入的 Cookie。
GET
https://testypro.iwai.cc/api/token/expire?token=your_api_token_here已鎖定本站string必填
用戶 API Token