GET
v1.0.0stable

Query Token Expiry

Retrieve the expiry time and validity status of an API token

GET/api/token/expire
Auth:API Key
Limite:120/minute

Richiesta parametri

Tutti i parametri possono essere passati tramite Query o Body

ParametroTipoObbligoDescrizione
token
stringObbligo
User API token
Esempio: your_api_token_here

Risposta

ParametroTipoObbligoDescrizione
code
numberObbligo
Status code: 1=success, 0=failure
Esempio: 1
msg
stringObbligo
Response message
Esempio: 查询成功
time
numberObbligo
Server timestamp (Unix seconds)
Esempio: 1769675945
data
objectObbligo
Response payload
data.username
stringObbligo
Username
Esempio: testuser
data.expire_time
numberObbligo
Expiry timestamp (Unix seconds). 0 means permanent
Esempio: 1769675945
data.status
stringObbligo
Status: permanent, valid, or expired
Esempio: valid
data.status_text
stringObbligo
Status text
Esempio: 有效
data.is_valid
booleanObbligo
Whether the token is valid
Esempio: true
data.remaining_seconds
numberObbligo
Remaining seconds (-1 means permanent)
Esempio: 2592000
data.remaining_days
numberObbligo
Remaining days (-1 means permanent)
Esempio: 30
data.expire_time_formatted
stringObbligo
Formatted expiry time (not returned if permanent)
Esempio: 2026-02-28 15:04:05
ysucc
stringObbligo
Success flag, returns "Ysucc" on success
Esempio: Ysucc
Esempio di risposta
{
"code":1,
"msg":"Query successful",
"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"
}

Permanent Token

Returns permanent when the token has no expiry set

Permanent Token
{
"code":1,
"msg":"Query successful",
"time":1769675945,
"data":
{
"username":"testuser",
"expire_time":0,
"status":"permanent",
"status_text":"永久有效",
"is_valid":true,
"remaining_seconds":-1,
"remaining_days":-1
}
,
"ysucc":"Ysucc"
}

Expired Token

Token has exceeded its expiry time

Expired Token
{
"code":1,
"msg":"Query successful",
"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"
}

Codici di errore

Codici di errore3 definito
0
Token is required
Token parameter is missing
0
Invalid token
Invalid token or has been replaced
0
Only GET requests are supported
Used non-GET method

Lingua di risposta

Personalizza il linguaggio di risposta API con l'intestazione X-Lang. Gli esempi di codice qui sotto utilizzano automaticamente la lingua del tuo sito corrente.

Intestazione consigliata
X-Lang: it
Lingue supportate
zh, en, zh-TW, vi, ar, es, ru

Accetta-Language è anche supportato; X-Lang prende la priorità.

Esempi di codice

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: it"

Note

  • expire_time 为 0 时表示 Token 永久有效
  • remaining_seconds/remaining_days 为 -1 时表示永久有效
  • 已过期的 Token 仍可查询有效期,但 is_valid 为 false
  • 已被替换的 Token 无法查询,会返回 token 不正确

Provalo in Console

Compila i parametri qui sotto e invia una richiesta al test. Le richieste vanno solo all'API di questo sito; l'URL è bloccato e non può essere modificato e il cookie di login corrente è incluso.

GEThttps://testypro.iwai.cc/api/token/expire?token=your_api_token_hereBloccato a questo sito
stringObbligo

User API token