Files
yuyueguahao/docs/api/v1/admin-auth.md
T
2026-07-05 14:43:34 +08:00

1.0 KiB

AdminAuth · 管理员鉴权

JWT (jsonwebtoken)。请求时 Header Authorization: Bearer <token>

接口表

Method Path 鉴权 说明
POST /api/v1/admin/auth/login - 登录
GET /api/v1/admin/auth/me 当前账号
POST /api/v1/admin/auth/change-password 修改密码

POST /api/v1/admin/auth/login

请求体

{ "username": "admin", "password": "Yygh@2026#Admin" }

响应

{
  "code": 0,
  "message": "登录成功",
  "data": {
    "token": "eyJhbGc...",
    "admin": { "id": "u-001", "username": "admin", "nickname": "系统管理员", "role": "super" }
  }
}

错误码

  • 400 用户名 / 密码必填
  • 401 用户名或密码错误
  • 500 服务器内部错误

POST /api/v1/admin/auth/change-password

请求体

{ "oldPassword": "...", "newPassword": "新密码至少 8 位" }

错误码

  • 400 原密码 / 新密码必填
  • 400 新密码至少 8 位
  • 400 原密码错误
  • 404 账号不存在