书籍摘要

核心定位

这本书不是教你快速搭一个 REST 接口的入门手册，而是把“API 该怎样长期演化、怎样保持一致性”拆成一组可复用设计模式。JJ Geewax 以 resource-oriented API 为主线，讨论命名、资源关系、标准方法、版本兼容、分页过滤、批处理与认证等问题，适合把 API 当成产品和平台能力来设计的读者。

内容主线

全书先用前两章解释什么是“好 API”以及为什么需要 pattern language，再逐步从原则走向机制：先统一命名、层级、数据类型和默认值，再进入资源标识、GET/List/Create/Update/Delete 等标准交互，随后扩展到部分更新、长任务、自定义方法、批量操作、软删除、去重、重试与请求校验。它强调的不是某个框架技巧，而是让接口在可理解性、可预测性和可运维性之间取得平衡。

章节内容

第一部分先建立评价标准，说明优秀 API 为什么要兼顾 operational、expressive、simple、predictable，并用一个类似 Twitter 的案例把后续模式串起来。

第二部分聚焦设计原则，讨论名称好坏、语法与上下文、资源层级、关系建模，以及布尔值、枚举、列表、映射、默认值和序列化等基础约定，帮助读者先把接口语言打磨清楚。

第三部分及后续各章进入高频工程问题：如何设计稳定标识符，何时坚持标准方法，何时引入 partial update、custom method、long-running operation、batch operation、pagination、filtering、import/export、versioning、soft deletion、request deduplication 与 authentication。每个主题都更像一份设计决策模板，而不是孤立技巧。

适用读者

适合后端工程师、平台/API 设计者、技术负责人，以及需要制定团队接口规范的人。若你已经会写 CRUD，但常在命名混乱、资源边界、兼容性或批量语义上反复返工，这本书很有价值。若你只想学某个 Web 框架的快速上手，或尚未理解 HTTP/API 基础，阅读门槛会偏高。

总评

《API Design Patterns》最强的地方，在于把分散的接口经验提炼成可以讨论、评审和复用的模式体系。它不追求炫技，而是帮助团队在长期演化中减少随意性。对正在建设公共 API、内部平台 API 或微服务接口规范的读者来说，这本书的价值主要体现在“少踩设计坑、提升一致性、让后续扩展更从容”。