docs-05-header-template.md 528 Bytes

05-API接口契约

BasePath: {{base_path}} 端口: 见 config-vars.yamlbackend.http_port(单一来源,不在此重复填)

全局约定

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

接口清单

(各模块接口段落见下方,由 downstream-gen 按 REQ 填入)