1.3 KiB
1.3 KiB
后台管理 · 认证模块
本文件描述
/api/admin下的认证相关接口(登录、当前管理员信息)。公共约定(请求头、统一响应、鉴权中间件、错误码、配置)见 admin-api.md。
1. 接口列表
1.1 POST /api/admin/login
后台管理员登录,签发 JWT。无需 Authorization 头。
请求体
{
"username": "admin",
"password": "admin123"
}
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
username |
string | 是 | 管理员账号(当前示例固定 admin)。 |
password |
string | 是 | 密码(当前示例固定 admin123;生产应接 DB + 密码哈希)。 |
响应
{ "code": 0, "msg": "ok", "data": { "token": "<JWT>" } }
curl 示例
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>
响应
{ "code": 0, "msg": "ok", "data": { "admin_id": "1" } }
2. 备注
- 后台账号:
POST /api/admin/login当前为固定示例账号,生产环境需接入数据库与密码哈希校验。