POST
v1.1.0stable修改 Token 有效期
修改当前 API Token 的有效期时间戳。expire_time 传 0 表示永久有效。
POST
/api/token/expire认证:API Key
限流:60/分钟
请求参数
所有请求参数需通过 Query 或 Body 传递
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
token | string | 必填 | 当前 API Token 示例: your_api_token_here |
expire_time | number | 必填 | 新的过期时间戳，支持 Unix 秒或毫秒；传 0 表示永久有效 示例: 1772267945 |
响应参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
code | number | 必填 | 状态码：1=成功，0=失败 示例: 1 |
msg | string | 必填 | 返回信息 示例: 设置已保存 |
data.username | string | 必填 | 用户名 示例: testuser |
data.expire_time | number | 必填 | 新的过期时间戳，0 表示永久有效 示例: 1772267945 |
data.status | string | 必填 | 状态：permanent 或 valid 示例: valid |
data.is_valid | boolean | 必填 | Token 是否有效 示例: true |
data.remaining_seconds | number | 必填 | 剩余有效秒数，永久有效时为 -1 示例: 2592000 |
响应示例
{}
"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"
错误码
错误码3 个定义
0token不能为空
未提供 token 参数
0失效时间不能为空
未提供 expire_time 或格式不正确
0失效时间必须是未来时间
expire_time 不是 0 且早于当前时间
响应语言
通过 X-Lang 请求头自定义接口返回语言。下方代码示例会自动使用您当前访问系统的语言。
推荐请求头
X-Lang: zh支持的语言
zh, en, zh-TW, vi, ar也可以使用 Accept-Language；X-Lang 优先级更高。不支持的语言将回退为英文。
代码示例
curl -X POST "https://testypro.iwai.cc,https://cer.xyul.cn,https://cer.iwai.cc/api/token/expire" \
-H "X-Lang: zh" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "token=your_api_token_here&expire_time=1772267945"注意事项
- 该接口会校验当前 token 是否有效，已过期 token 不能用于修改有效期
- expire_time 支持秒级或毫秒级时间戳，传 0 可设置为永久有效
- 修改成功后会清除旧 token 缓存，后续请求立即按新有效期校验
在控制台试一试
填好参数后直接点发送测试，接口地址固定为本站，会带上当前登录状态
POST
https://testypro.iwai.cc/api/token/expire已锁定本站string必填
当前 API Token
number必填
新的过期时间戳，支持 Unix 秒或毫秒；传 0 表示永久有效