49 lines
1.0 KiB
Markdown
49 lines
1.0 KiB
Markdown
# 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
|
|
|
|
**请求体**
|
|
```json
|
|
{ "username": "admin", "password": "Yygh@2026#Admin" }
|
|
```
|
|
|
|
**响应**
|
|
```json
|
|
{
|
|
"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
|
|
|
|
**请求体**
|
|
```json
|
|
{ "oldPassword": "...", "newPassword": "新密码至少 8 位" }
|
|
```
|
|
|
|
**错误码**
|
|
- 400 原密码 / 新密码必填
|
|
- 400 新密码至少 8 位
|
|
- 400 原密码错误
|
|
- 404 账号不存在
|