作者背景#

本書由三位在 API 平台領域擁有豐富實戰經驗的工程師合著。Brenda Jin 曾任 Slack 開發者平台資深工程師，負責設計與擴展面向第三方開發者的 API，同時也是 Girl Develop It 的董事會成員。Saurabh Sahni 為 Slack 平台團隊首席工程師，擁有十五年以上建構開發者平台與 API 的經驗，曾主導 Slack 公開 API 設計規範的制定，此前任職於 Yahoo 開發者網路。Amir Shevat 曾任 Twitch 開發者體驗副總裁，先後在 Google、Microsoft 與 Slack 負責開發者產品與 API 生態系建設，亦為《Designing Bots》一書作者。

完整摘要#

《Designing Web APIs》探討的核心問題是：如何設計出讓開發者喜愛使用的 Web API。書中首先釐清 API 的本質與商業價值——API 不僅是技術介面，更是現代平台商業模式的關鍵元件，可作為產品本身、生態系催化劑或整合橋梁。接著全面比較 REST、RPC、GraphQL 三種請求—回應典範，以及 WebHooks、WebSockets、HTTP Streaming 三種事件驅動典範，並以 Stripe、Slack、GitHub 等公司的實際案例說明各自的優劣與適用場景。

設計最佳實踐部分構成本書的核心框架：以真實使用場景驅動設計、打造優秀的開發者體驗（Developer Experience）、追求命名與型別的一致性、提供有意義的錯誤訊息，以及透過版本管理與向後相容策略確保 API 的可擴展性。書中還涵蓋 API 安全（認證、授權、限流）、實際設計流程、規模擴展策略、變更管理，以及開發者生態系經營（文件、SDK、開發者計畫）等完整面向。全書貫穿來自 Stripe、GitHub、Slack、Twitch 等公司的第一手案例與專家訪談，使理論與實務緊密結合。

本書的貢獻與定位#

本書填補了 API 設計領域中「從零到一的實務指南」的空白。相較於 Leonard Richardson 的《RESTful Web APIs》偏重 REST 理論，本書以更廣泛的視角涵蓋多種 API 典範，並深入開發者體驗與生態系經營等非技術面向。適合正在建構或維護公開 API 的後端工程師、平台架構師與技術產品經理。