POST
v1.1.0stable

Update Token

Generate a new API token and invalidate the old token immediately.

POST/api/token/update
Auth:API Key
Granica:30/minute

Parametry żądania

Wszystkie parametry mogą być przekazywane za pośrednictwem zapytania lub ciała

ParametrRodzajWymaganeOpis
token
stringWymagane
Current API token. It becomes invalid immediately after success
Przykład: your_api_token_here

Odpowiedź

ParametrRodzajWymaganeOpis
code
numberWymagane
Status code: 1=success, 0=failure
Przykład: 1
msg
stringWymagane
Response message
Przykład: 刷新成功
data.username
stringWymagane
Username
Przykład: testuser
data.token
stringWymagane
New API token
Przykład: new_api_token_here
data.expire_time
numberWymagane
Expiry timestamp inherited by the new token. 0 means permanent
Przykład: 1772267945
data.old_token_invalidated
booleanWymagane
Whether the old token has been invalidated
Przykład: true
Przykład odpowiedzi
{
"code":1,
"msg":"Refreshed successfully",
"time":1769675945,
"data":
{
"username":"testuser",
"token":"new_api_token_here",
"expire_time":1772267945,
"old_token_invalidated":true
}
,
"ysucc":"Ysucc"
}

Kod błędu

Kod błędu3 zdefiniowane
0
Token is required
Missing token parameter
0
Invalid token
Token is invalid, replaced, or the account status is unavailable
0
Token expired
Expired tokens cannot update tokens

Język odpowiedzi

Dostosuj język odpowiedzi API do nagłówka X- Lang. Poniższe przykłady kodów automatycznie korzystają z aktualnego języka strony.

Zalecany nagłówek
X-Lang: pl
Obsługiwane języki
zh, en, zh-TW, vi, ar, es, ru

Obsługiwane jest również Accept- Language; X- Lang ma pierwszeństwo. Nieobsługiwane języki podążają za zapasami języka strony.

Przykłady kodów

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

Uwagi

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

Spróbuj w konsoli

Wypełnij poniższe parametry i wyślij wniosek o przetestowanie. Żądania są kierowane tylko do API tej witryny; adres URL jest zablokowany i nie może być zmieniony, a obecne pliki cookie logowania są włączone.

POSThttps://testypro.iwai.cc/api/token/updateZamknięte na tej stronie
stringWymagane

Current API token. It becomes invalid immediately after success