54 lines
1.3 KiB
Markdown
54 lines
1.3 KiB
Markdown
# 后台管理 · 认证模块
|
||
|
||
> 本文件描述 `/api/admin` 下的**认证相关**接口（登录、当前管理员信息）。公共约定（请求头、统一响应、鉴权中间件、错误码、配置）见 [admin-api.md](./admin-api.md)。
|
||
|
||
## 1. 接口列表
|
||
|
||
### 1.1 `POST /api/admin/login`
|
||
|
||
后台管理员登录，签发 JWT。无需 `Authorization` 头。
|
||
|
||
**请求体**
|
||
|
||
```json
|
||
{
|
||
"username": "admin",
|
||
"password": "admin123"
|
||
}
|
||
```
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `username` | string | 是 | 管理员账号（当前示例固定 `admin`）。 |
|
||
| `password` | string | 是 | 密码（当前示例固定 `admin123`；生产应接 DB + 密码哈希）。 |
|
||
|
||
**响应**
|
||
|
||
```json
|
||
{ "code": 0, "msg": "ok", "data": { "token": "<JWT>" } }
|
||
```
|
||
|
||
**curl 示例**
|
||
|
||
```bash
|
||
curl -X POST http://localhost:8080/api/admin/login \
|
||
-H "Content-Type: application/json" \
|
||
-d '{"username":"admin","password":"admin123"}'
|
||
```
|
||
|
||
### 1.2 `GET /api/admin/info`
|
||
|
||
受保护接口示例，需有效 JWT，返回当前管理员 ID。
|
||
|
||
**请求头**：`Authorization: Bearer <JWT>`
|
||
|
||
**响应**
|
||
|
||
```json
|
||
{ "code": 0, "msg": "ok", "data": { "admin_id": "1" } }
|
||
```
|
||
|
||
## 2. 备注
|
||
|
||
- **后台账号**：`POST /api/admin/login` 当前为固定示例账号，生产环境需接入数据库与密码哈希校验。
|