# 05-API接口契约

BasePath: `{{base_path}}`
端口: `【人工填写：后端端口，默认 8080】`

## 全局约定

### 响应格式
```json
{"code": 200, "message": "操作成功", "data": {}, "timestamp": 1700000000000}
```

### 错误码
| 范围 | 含义 |
|---|---|
| 200 | 成功 |
| 400xx | 客户端参数错误 |
| 401xx | 认证/授权错误 |
| 403xx | 权限不足 |
| 404xx | 资源不存在 |
| 500xx | 服务端内部错误 |

### 鉴权
{{auth_note}}

### 分页参数
{{pagination_note}}

## 接口清单
（各模块接口段落见下方，由 `build-db` 按 REQ 填入）