> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.

# API 使用说明

## Base URL

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

## 请求头

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

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

## 权限标识

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

## 响应

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

`success` 表示业务结果，HTTP 状态仍用于认证、验证和传输错误。详情见[响应与错误](/api/responses.md)。

## 源码依据

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