#API 使用说明

#Base URL

开发环境默认前端通过 http://localhost:8000 请求后端，生产环境由 VITE_BASE_URL 决定。本文路径均省略 Base URL。

#请求头

Authorization: Bearer <token>
User-Language: zh
Content-Type: application/json

文件上传使用 multipart/form-data。除明确标记公开的路由外，管理接口应携带有效 Token 并具备对应权限。

#权限标识

表中列出控制器类级前缀与方法 authorize 组合的权限键。/system 当前用户接口没有相同的前缀声明，应结合认证要求理解。

#响应

{ "data": [], "success": true, "msg": "ok", "showType": 0 }

success 表示业务结果，HTTP 状态仍用于认证、验证和传输错误。详情见响应与错误。

#源码依据

端点表来自 app/Http/Controllers/Admin/ 的当前路由属性。新增或修改接口时，应同步更新前端 src/api/、权限规则和双语参考文档。