后端 API 开发方法论

API 契约管理

契约来源

实现 API 前，必须阅读 architecture.md §5（API 设计），获取：

• API 规范（RESTful/GraphQL）
• 接口列表（方法、路径、描述、认证要求）
• 请求/响应格式约定
• 错误码规范

契约遵守原则

1. 严格实现：API 端点的方法、路径、参数必须与 architecture.md §5 一致
2. 响应格式：遵循统一的成功/错误响应结构
3. 偏差记录：如需偏离契约，必须在输出报告中标注原因
4. 类型导出：将请求/响应类型导出到共享文件，供前端引用