# 后台管理 · 认证模块

> 本文件描述 `/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` 当前为固定示例账号，生产环境需接入数据库与密码哈希校验。