API、协议与服务边界

从 HTTP 资源、GraphQL Schema、gRPC 合约到可靠性治理，建立跨语言 API 设计主线。

阅读起点

学习前先阅读：后端开发基础学习路线。

全书顺序

本书按知识依赖组织。主线先建立可运行的共同模型，再进入机制、工程边界和生产约束；维护与前沿内容明确标注，不改变主线的学习顺序。

第1章｜HTTP API 与输入输出契约

能设计可演进、可验证的 HTTP API。

1. 资源、方法与状态码：把业务动作映射到 HTTP 语义。
2. 输入校验与错误模型：统一边界校验、错误码和敏感信息处理。
3. 分页、过滤与幂等：处理列表、重复请求和长任务。
4. 认证、版本与治理：组织授权、兼容和契约测试。

第2章｜GraphQL 与 gRPC 合约

比较 Schema 执行和 RPC 调用的边界与代价。

1. GraphQL 类型与执行：理解 schema、resolver、N+1 和成本。
2. GraphQL 缓存与订阅：处理客户端缓存、订阅和安全治理。
3. Protobuf 与 gRPC 调用：组织 schema、metadata、拦截器和流。
4. 重试、背压与网关：为 RPC 可靠性、网关和可观测性设界。

阅读边界

本页是学习路线和专题入口，不替代专题笔记中的机制解释、可运行示例和练习。笔记尚未完成的专题会先显示为占位页；已有经验的读者可以跳到具体章节，再按前置关系回补。

路线状态

本路线的目录已完成本轮架构审查；专题笔记的内容质量和来源审查另行进行。