本书从“由外而内”的角度引入API设计，重视反映客户和产品团队的声音，将需求映射到特定的、组织良好的API，为编写这些API选择正确的风格，并从零开始实现了一个真实的例子，旨在为设计新API或扩展现有API的人提供指导，帮助他们了解如何通过正确的设计过程来交付优秀的API，如何与设计团队、客户和其他涉众就具体的成果达成一致，如何确定正确的API并将操作整合成统一的API配置文件，以及如何使API程序实现可伸缩的设计和管理过程。本书适合所有参与规划或构建API的读者阅读，包括架构师、开发人员、团队领导者、单团队和多团队环境中的项目管理人员，以及相关技术人员或业务专业人员。

第一部分 Web API设计简介
第1章 API设计原则
1.1 Web API设计要素
1.1.1 业务功能
1.1.2 产品思维
1.1.3 开发者体验
1.2 API设计即沟通
1.3 审查软件设计的原则
1.3.1 模块化
1.3.2 封装
1.3.3 高内聚和松耦合
1.4 基于资源的API设计
1.5 资源不是对象或领域模型
1.6 基于资源的API交换消息
1.7 Web API设计原则
1.8 小结
第2章 协作式API设计
2.1 为什么需要API设计流程？
2.2 API设计流程反模式
2.2.1 泄露抽象反模式
2.2.2 下一个版本设计修复反模式
2.2.3 英雄设计工作反模式
2.2.4 未使用的API反模式
2.3 API设计优先的方法
2.4 API设计优先并保持敏捷
2.4.1 重新审视敏捷宣言
2.4.2 API设计优先的敏捷性
2.5 对齐-定义-设计-优化流程
2.6 DDD在API设计中的作用
2.7 API设计涉及每一个人
2.8 有效应用ADDR流程
2.9 小结
第二部分 对齐API的结果
第3章 明确数字功能
3.1 确保利益相关者思路对齐
3.2 什么是数字功能？
3.3 专注于要完成的工作
3.4 什么是任务用例？
3.5 任务用例的组成部分
3.6 为API编写任务用例
3.6.1 方法1：当问题已知时
3.6.2 方法2：当期望的结果已知时
3.6.3 方法3：当数字功能已确定时
3.7 克服任务用例的挑战
3.7.1 挑战1：任务用例过于详细
3.7.2 挑战2：任务用例以功能为中心
3.7.3 挑战3：任务用例需要额外的用户上下文
3.8 收集任务用例的技巧
3.9 现实世界中的API设计项目
3.10 任务用例示例
3.11 小结
第4章 收集操作和步骤
4.1 将任务用例扩展为操作及其对应的步骤
4.1.1 确定每个任务用例的操作
4.1.2 将每个操作分解为若干步骤
4.1.3 如果需求不明确，怎么办？
4.2 通过事件风暴实现协作式 理解
4.3 事件风暴的工作方式
4.3.1 步骤1：明确领域事件
4.3.2 步骤2：创建事件描述
4.3.3 步骤3：查看描述并确定差距
4.3.4 步骤4：扩展领域理解力
4.3.5 步骤5：查看最终描述
4.4 事件风暴的好处
4.5 主持事件风暴会议
4.5.1 准备：收集必要的材料 用品
4.5.2 分享：沟通事件风暴会议
4.5.3 主持：进行事件风暴会议
4.5.4 总结：收集操作和步骤
4.5.5 跟进：会后建议
4.5.6 定制流程
4.6 小结
第三部分 定义候选API
第5章 明确API边界
5.1 避免API边界反模式
5.1.1 大型一体化API反模式
5.1.2 过载API反模式
5.1.3 辅助API反模式
5.2 有界上下文、子域和API
5.3 使用事件风暴探索API边界
5.4 通过操作找到API边界
5.5 为API命名并确定其范围
5.6 小结
第6章 API建模
6.1 什么是API建模？
6.2 API建模流程
6.2.1 步骤1：收集API配置文件摘要
6.2.2 步骤2：确定资源
6.2.3 步骤3：定义API分类法
6.2.4 步骤4：添加操作事件
6.2.5 步骤5：扩展操作的详细信息
6.3 用序列图验证API模型
6.4 评估API的优先级和重用性
6.5 小结
第四部分 设计API
第7章 基于REST的API设计
7.1 什么是基于REST的API？
7.1.1 REST是客户-服务器体系结构
7.1.2 REST是以资源为中心的
7.1.3 REST是基于消息的
7.1.4 REST支持分层架构
7.1.5 REST支持按需编码
7.1.6 超媒体控制
7.1.7 什么时候选择REST
7.2 REST API设计流程
7.2.1 步骤1：设计资源URL路径
7.2.2 步骤2：将API操作映射到HTTP方法上
7.2.3 步骤3：分配响应代码
7.2.4 步骤4：记录REST API设计
7.2.5 步骤5：分享并收集反馈
7.3 选择一种表征格式
7.3.1 资源序列化
7.3.2 超媒体序列化
7.3.3 超媒体消息传递
7.3.4 语义超媒体消息传递
7.4 常见的REST设计模式
7.4.1 创建-读取-更新-删除
7.4.2 扩展资源生命周期支持
7.4.3 单例资源
7.4.4 后台（队列）作业
7.4.5 REST中的长期运行事务支持
7.5 小结
第8章 RPC和基于查询的API设计
8.1 什么是基于RPC的API？
8.1.1 gRPC
8.1.2 使用RPC时应该考虑的因素
8.2 RPC API设计流程
8.2.1 步骤1：确定RPC操作
8.2.2 步骤2：细化RPC操作
8.2.3 步骤3：记录API设计
8.3 什么是基于查询的API？
8.3.1 了解OData
8.3.2 探索GraphQL
8.4 基于查询的API设计流程
8.4.1 步骤1：设计资源和图结构
8.4.2 步骤2：设计查询和突变操作
8.4.3 步骤3：记录API设计
8.5 小结
第9章 用于事件和流的异步API
9.1 API轮询的问题
9.2 异步API创造新的可能性
9.3 回顾消息传递的