# 05-API接口契约

BasePath: `{{base_path}}`
端口: 见 `config-vars.yaml` 的 `backend.http_port`（单一来源，不在此重复填）

## 全局约定

响应格式 / 异常 / 错误码 / 认证 / 分页等全局约定的 SSoT 在 `docs/04`（响应格式见 § 1.4、异常处理见 § 1.5、认证见 § 1.7、分页查询见 § 3.2），此处不重复。各端点专属的请求 / 响应 / 错误码见下方接口清单。

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