认证接口

登录、验证码、刷新令牌与退出登录的统一参考。

接口一览

接口	方法	说明
/api/v1/auth/captcha	GET	获取图形验证码
/api/v1/auth/login	POST	用户名密码登录
/api/v1/auth/refresh-token	POST	刷新访问令牌
/api/v1/auth/logout	DELETE	退出登录

获取验证码

请求

GET /api/v1/auth/captcha

响应

{
  "code": "00000",
  "msg": "成功",
  "data": {
    "captchaId": "uuid",
    "captchaBase64": "data:image/png;base64,..."
  }
}

登录

请求

POST /api/v1/auth/login
Content-Type: application/json

{
  "username": "admin",
  "password": "123456",
  "captchaId": "uuid",
  "captchaCode": "1234"
}

响应

{
  "code": "00000",
  "msg": "成功",
  "data": {
    "accessToken": "eyJhbGciOiJIUzI1NiIs...",
    "refreshToken": "eyJhbGciOiJIUzI1NiIs...",
    "tokenType": "Bearer",
    "expiresIn": 7200
  }
}

刷新令牌

请求

POST /api/v1/auth/refresh-token?refreshToken=eyJhbGciOiJIUzI1NiIs...

响应

{
  "code": "00000",
  "msg": "成功",
  "data": {
    "accessToken": "eyJhbGciOiJIUzI1NiIs...",
    "refreshToken": "eyJhbGciOiJIUzI1NiIs...",
    "tokenType": "Bearer",
    "expiresIn": 7200
  }
}

退出登录

请求

DELETE /api/v1/auth/logout
Authorization: Bearer {accessToken}

响应

{
  "code": "00000",
  "msg": "成功"
}