Skip to content

认证接口

登录

临时 Token 登录

http
GET /login/token?token={token}

参数

参数类型说明
tokenstring临时登录 token

响应

成功后重定向到 /,并设置 auth_token Cookie。

验证 Token

http
POST /api/auth/verify

请求头

Authorization: Bearer {jwt_token}

响应

json
{
  "success": true,
  "data": {
    "userId": "123456789",
    "username": "用户名",
    "isAdmin": true,
    "exp": 1702656000
  }
}

登出

http
POST /api/auth/logout

响应

json
{
  "success": true
}

清除 auth_token Cookie。

刷新 Token

http
POST /api/auth/refresh

响应

json
{
  "success": true,
  "data": {
    "token": "new_jwt_token"
  }
}

获取当前用户

http
GET /api/auth/me

响应

json
{
  "success": true,
  "data": {
    "userId": "123456789",
    "username": "用户名",
    "avatar": "https://...",
    "isAdmin": true
  }
}

错误响应

未认证

json
{
  "success": false,
  "error": "Unauthorized",
  "code": "AUTH_REQUIRED"
}

Token 过期

json
{
  "success": false,
  "error": "Token expired",
  "code": "TOKEN_EXPIRED"
}

Token 无效

json
{
  "success": false,
  "error": "Invalid token",
  "code": "INVALID_TOKEN"
}

基于 MIT 许可发布