Files
2026-10-25 22:47:13 +08:00

1.3 KiB
Raw Permalink Blame History

后台管理 · 认证模块

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