认证接口

管理员认证相关接口,使用 JWT Token 进行身份验证。

登录

管理员登录,获取 JWT Token。

方法POST
路径/api/v1/auth/login
认证无需

请求参数

字段类型必填说明
usernamestring是用户名
passwordstring是密码

请求示例

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

{
  "username": "admin",
  "password": "admin123"
}

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "token": "eyJhbGciOiJIUzI1NiIs...",
    "user": {
      "id": 1,
      "username": "admin"
    }
  }
}

获取当前用户信息

方法GET
路径/api/v1/auth/profile
认证需要 Token

请求头

Authorization: Bearer <token>

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "id": 1,
    "username": "admin",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

修改密码

方法PUT
路径/api/v1/auth/password
认证需要 Token

请求参数

字段类型必填说明
old_passwordstring是旧密码
new_passwordstring是新密码

请求示例

PUT /api/v1/auth/password
Authorization: Bearer <token>
Content-Type: application/json

{
  "old_password": "admin123",
  "new_password": "new_password_456"
}

响应示例

{
  "code": 200,
  "message": "密码修改成功"
}

👉 下一节:项目管理接口