Cập nhật Token

Tạo API Token mới và vô hiệu token cũ ngay lập tức.

POST/api/token/update

Xác thực:API Key

Giới hạn:30/phút

Tham số yêu cầu

Tất cả tham số có thể truyền qua Query hoặc Body

Tham số	Loại	Bắt buộc	Mô tả
`token`	string	Bắt buộc	API Token hiện tại, sẽ mất hiệu lực ngay sau khi thành công Ví dụ: your_api_token_here

Phản hồi

Tham số	Loại	Bắt buộc	Mô tả
`code`	number	Bắt buộc	Mã trạng thái Ví dụ: 1
`msg`	string	Bắt buộc	Thông báo phản hồi Ví dụ: 刷新成功
`data.username`	string	Bắt buộc	Tên người dùng Ví dụ: testuser
`data.token`	string	Bắt buộc	API Token mới Ví dụ: new_api_token_here
`data.expire_time`	number	Bắt buộc	Timestamp hết hạn mà token mới kế thừa, 0 nghĩa là vĩnh viễn Ví dụ: 1772267945
`data.old_token_invalidated`	boolean	Bắt buộc	Token cũ đã bị vô hiệu chưa Ví dụ: true

Ví dụ phản hồi

{

"code":1,

"msg":"Làm mới thành công",

"time":1769675945,

"data":

{

"username":"testuser",

"token":"new_api_token_here",

"expire_time":1772267945,

"old_token_invalidated":true

}

"ysucc":"Ysucc"

}

Mã lỗi

Mã lỗi3 được định nghĩa

0

Token không được để trống

Thiếu tham số token

0

Token không chính xác

Token không hợp lệ, đã bị thay thế hoặc trạng thái tài khoản không khả dụng

0

Token đã hết hạn

Token hết hạn không thể cập nhật token

Ngôn ngữ phản hồi

Tùy chỉnh ngôn ngữ phản hồi API bằng header X-Lang. Ví dụ mã bên dưới tự động sử dụng ngôn ngữ trang hiện tại của bạn.

Header đề xuất

X-Lang: vi

Ngôn ngữ được hỗ trợ

zh, en, zh-TW, vi, ar

Bạn cũng có thể dùng Accept-Language; X-Lang có ưu tiên cao hơn. Ngôn ngữ không được hỗ trợ sẽ chuyển sang tiếng Anh.

Ví dụ mã

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

Lưu ý

Sau khi thành công, token cũ mất hiệu lực ngay và các yêu cầu sau phải dùng token mới
Token mới kế thừa cấu hình thời hạn của token cũ
Cache token cũ được xóa sau khi thành công

Thử trong Console

Điền các tham số bên dưới rồi gửi yêu cầu để kiểm tra. Yêu cầu chỉ gửi đến API của trang này; địa chỉ đã bị khóa và không thể thay đổi, đồng thời kèm theo Cookie đăng nhập hiện tại của bạn.

POSThttps://testypro.iwai.cc/api/token/updateĐã khóa vào trang này

tokenstringBắt buộc

API Token hiện tại, sẽ mất hiệu lực ngay sau khi thành công