docs-05-header-template.md
528 Bytes
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 填入)