Cập nhật hạn Token

Cập nhật thời gian hết hạn của API Token hiện tại. Đặt expire_time bằng 0 để token vĩnh viễn.

POST/api/token/expire

Xác thực:API Key

Giới hạn:60/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 Ví dụ: your_api_token_here
`expire_time`	number	Bắt buộc	Timestamp hết hạn mới theo giây hoặc mili giây Unix. Dùng 0 để vĩnh viễn Ví dụ: 1772267945

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.expire_time`	number	Bắt buộc	Timestamp hết hạn mới, 0 nghĩa là vĩnh viễn Ví dụ: 1772267945
`data.status`	string	Bắt buộc	Trạng thái: permanent hoặc valid Ví dụ: valid
`data.is_valid`	boolean	Bắt buộc	Token có hợp lệ không Ví dụ: true
`data.remaining_seconds`	number	Bắt buộc	Số giây còn lại, -1 khi vĩnh viễn Ví dụ: 2592000

Ví dụ phản hồi

{

"code":1,

"msg":"Đã lưu cài đặt",

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

}

Mã lỗi

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

0

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

Thiếu tham số token

0

Thời gian hết hạn không được để trống

Thiếu hoặc sai expire_time

0

Thời gian hết hạn phải ở tương lai

expire_time không phải 0 và nhỏ hơn hiện tại

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

Lưu ý

Token hiện tại phải còn hiệu lực. Token hết hạn không thể cập nhật thời hạn
expire_time hỗ trợ giây hoặc mili giây. Dùng 0 để đặt vĩnh viễn
Cache token được xóa sau khi cập nhật để thời hạn mới có hiệu lực ngay

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/expireĐã khóa vào trang này

tokenstringBắt buộc

API Token hiện tại

expire_timenumberBắt buộc

Timestamp hết hạn mới theo giây hoặc mili giây Unix. Dùng 0 để vĩnh viễn