admin-vue3/docs/管理后台接口设计文档.md

管理后台接口设计文档

约定

• BaseURL: /api
• 认证：Bearer Token（Authorization: Bearer ）
• 响应规范：{ code, msg, data }

接口一览（示例）

登录

• 方法：POST /auth/login
• 请求：{ username, password }
• 响应：{ token, expireAt }

用户列表

• 方法：GET /system/users
• 查询：page, size, keyword
• 响应：{ total, list: [ {id, username, deptName, status} ] }

创建用户

• 方法：POST /system/users
• 请求：{ username, password, deptId, roleIds, tenantId }
• 响应：{ id }

角色列表

• 方法：GET /system/roles

菜单树

• 方法：GET /system/menus/tree

错误码

• 400 参数错误；401 未认证；403 无权限；404 不存在；500 服务器异常