书籍摘要

《Design and Build Great Web APIs》是由Mike Amundsen撰写的一本关于设计和构建高质量Web API的实用指南。本书由The Pragmatic Bookshelf于2020年出版，旨在帮助开发者从零开始设计、构建和部署健壮、可靠且具有弹性的Web API。

内容概述

本书内容分为五个部分，涵盖了从设计到部署的完整API开发流程。

第一部分：Getting Started（开始篇）

• API-First原则：介绍API优先的设计理念，强调从用户需求出发，设计出符合业务目标的API。
• HTTP协议与REST风格：回顾Web开发中常用的HTTP协议和REST风格，为后续API设计奠定基础。
• curl工具：通过curl命令行工具探索现有API，帮助读者熟悉API的交互方式。

第二部分：The Design Phase（设计篇）

• API建模与设计：探讨如何通过故事、工作流和内部循环文档来收集和整理API需求。
• Node Package Manager（npm）：介绍如何使用npm管理API项目，包括依赖管理和项目文档生成。
• 设计方法论：结合Donald Norman的设计理论，提出一种基于“任务要完成”（Jobs to be Done）的API设计方法，确保API设计能够解决实际问题。

第三部分：The Build Phase（构建篇）

• API草图与原型：通过Apiary Blueprint和OpenAPI Specification（OAS）创建API草图和原型，快速验证设计思路。
• NodeJS与DARRT框架：使用NodeJS和DARRT框架将设计转化为实际代码，实现API的功能。
• 代码实现：详细介绍了如何将API设计转化为具体的代码实现，包括数据处理、资源定义和响应格式化。

第四部分：The Release Phase（发布篇）

• API测试：讲解如何使用Postman和newman进行API测试，包括行为驱动开发（BDD）和“快乐路径”与“悲伤路径”测试。
• API安全性：介绍如何使用OAuth和Auth0平台实现API的安全认证和授权。
• API部署：探讨如何将API部署到云平台，如Heroku，并进行持续集成和持续部署（CI/CD）。

第五部分：Appendixes（附录）

• 工具安装与配置：提供安装和配置开发工具的指南，包括curl、npm、Git等。
• 章节练习答案：为书中各章节的练习题提供参考答案，帮助读者巩固所学知识。
• API项目资产清单：列出开发过程中需要创建和管理的API项目资产，如设计文档、测试用例等。

适用人群

本书适合以下几类读者：

• 初级开发者：希望通过系统学习掌握Web API开发的完整流程。
• 高级开发者：需要深入了解API设计的最佳实践和高级技术。
• API产品经理：希望为团队提供统一的API设计和开发指导。
• 架构师：需要掌握如何设计和构建可扩展、可靠的API架构。

特色与优势

• 实战性强：通过具体的代码示例和项目实践，帮助读者快速上手。
• 理论与实践结合：不仅讲解设计理论，还提供详细的实现步骤和代码。
• 工具丰富：介绍了多种开发工具和框架，如NodeJS、npm、Postman等，方便读者选择适合自己的工具。
• 持续更新：作者在书中提供了在线资源和代码下载链接，方便读者获取最新的学习材料。

总之，《Design and Build Great Web APIs》是一本全面、实用且易于上手的API开发指南，无论是新手还是经验丰富的开发者，都能从中获得宝贵的指导和启发。