GET
v1.0.0stable查询 Token 有效期
查询 API Token 的有效期与有效状态
GET
/api/token/expire认证:API Key
限流:120/分钟
请求参数
所有请求参数需通过 Query 或 Body 传递
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
token | string | 必填 | 用户 API Token 示例: your_api_token_here |
响应参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
code | number | 必填 | 状态码：1=成功，0=失败 示例: 1 |
msg | string | 必填 | 返回信息 示例: 查询成功 |
time | number | 必填 | 服务器时间戳（Unix 秒） 示例: 1769675945 |
data | object | 必填 | 业务数据 |
data.username | string | 必填 | 用户名 示例: testuser |
data.expire_time | number | 必填 | 过期时间戳（Unix 秒），0 表示永久有效 示例: 1769675945 |
data.status | string | 必填 | 状态：permanent=永久有效，valid=有效，expired=已过期 示例: valid |
data.status_text | string | 必填 | 状态描述文本 示例: 有效 |
data.is_valid | boolean | 必填 | Token 是否有效 示例: true |
data.remaining_seconds | number | 必填 | 剩余有效秒数（-1 表示永久有效） 示例: 2592000 |
data.remaining_days | number | 必填 | 剩余有效天数（-1 表示永久有效） 示例: 30 |
data.expire_time_formatted | string | 必填 | 格式化的过期时间（永久有效时不返回） 示例: 2026-02-28 15:04:05 |
ysucc | string | 必填 | 成功标识，成功时返回 "Ysucc" 示例: Ysucc |
响应示例
{}
"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"
永久有效
Token 未设置有效期时返回永久有效
永久有效
{}
"code":1,
"msg":"查询成功",
"time":1769675945,
"data":
{}
,"username":"testuser",
"expire_time":0,
"status":"permanent",
"status_text":"永久有效",
"is_valid":true,
"remaining_seconds":-1,
"remaining_days":-1
"ysucc":"Ysucc"
Token 已过期
Token 已超过有效期
Token 已过期
{}
"code":1,
"msg":"查询成功",
"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"
错误码
错误码3 个定义
0token不能为空
未提供 Token 参数
0token不正确
Token 无效或已被替换
0仅支持GET请求
使用了非 GET 方法
响应语言
通过 X-Lang 请求头自定义接口返回语言。下方代码示例会自动使用您当前访问系统的语言。
推荐请求头
X-Lang: zh支持的语言
zh, en, zh-TW, vi, ar也可以使用 Accept-Language；X-Lang 优先级更高。不支持的语言将回退为英文。
代码示例
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: zh"注意事项
- expire_time 为 0 时表示 Token 永久有效
- remaining_seconds/remaining_days 为 -1 时表示永久有效
- 已过期的 Token 仍可查询有效期，但 is_valid 为 false
- 已被替换的 Token 无法查询，会返回 token 不正确
在控制台试一试
填好参数后直接点发送测试，接口地址固定为本站，会带上当前登录状态
GET
https://testypro.iwai.cc/api/token/expire?token=your_api_token_here已锁定本站string必填
用户 API Token