本书分为四部分，共十章，提供了关于设计、运维和演进API架构的全景图。本书以一个虚拟的案例贯穿始终，即如何通过小步快跑的策略，将一个用三层架构方式设计的传统应用系统迭代为一个基于API的现代架构。全书囊括了从设计、测试、运维、安全、部署和发布等整个软件生命周期的各个环节，其中第一部分介绍API的设计、构建和测试，第二部分介绍如何开展API流量管理，第三部分阐述API运维、发布和安全管理之道，第四部分介绍API架构的迭代演进，本书内容贴近实践，易于理解和应用。

序
前言
第0章 导论
0.1 架构之旅
0.2 API简介
0.3 真实示例：会议系统案例研究
0.3.1 会议案例研究中的API类型
0.3.2 改进会议系统的原因
0.3.3 从分层架构到API建模
0.3.4 案例研究：演进步骤
0.3.5 API基础设施和流量模式
0.3.6 会议系统案例研究的路线图
0.4 使用C4图表
0.4.1 C4上下文关系图
0.4.2 C4容器图
0.4.3 C4组件图
0.5 使用架构决策记录
0.5.1 参会者演进ADR
0.5.2 精通API：ADR指南
0.6 小结
第一部分 设计、构建和测试API
第1章 设计、构建和规范API
1.1 案例研究：设计参会者API
1.2 REST介绍
1.2.1 通过示例介绍REST和HTTP
1.2.2 Richardson成熟度模型
1.3 RPC API介绍
1.4 GraphQL简要介绍
1.5 REST API标准和结构
1.5.1 集合和分页
1.5.2 过滤集合
1.5.3 错误处理
1.5.4 ADR指南：选择API标准
1.6 使用OpenAPI规范定义REST API
1.7 OpenAPI规范的实际应用
1.7.1 代码生成
1.7.2 OpenAPI验证
1.7.3 示例和模拟
1.7.4 检测变更
1.8 API版本控制
1.8.1 语义化版本控制
1.8.2 OpenAPI规范和版本控制
1.9 用gRPC实现RPC
1.10 交互建模和API格式选择
1.10.1 高流量服务
1.10.2 大尺寸交互负载
1.10.3 HTTP/2的性能优势
1.10.4 旧格式处理
1.11 指南：交互建模
1.12 同时使用多个规范
1.12.1 是否存在黄金规范
1.12.2 合并规范的挑战
1.13 小结
……
第二部分 API流量管理
第三部分 API运维与安全
第四部分 使用API的演进架构