【簡介】 「本書綜合了理論與實務，包含許多深度見解但不失大局觀。這些見解基於豐富的實務經驗，並以嚴謹的學術方式撰寫，同時結合從業人員的回饋。我深信本書會為社群帶來幫助。」 —PROF. DR. DR. H. C. FRANK LEYMANN, MANAGING DIRECTOR, INSTITUTE OF ARCHITECTURE OF APPLICATION SYSTEMS, UNIVERSITY OF STUTTGART 適用於任何領域、技術或平台的API設計模式 API為各組織及生態系帶來突破性創新及數位轉型。架構師、設計師及開發者們需要專業設計指南，以建立友善、可信賴且高效的API。本書解決複雜的API通訊及內容，介紹可用於任何技術或平台的API設計方針。 集結五位作者撰寫的專業內容，從專案啟動、設定目標，到定義需求、細化設計、規劃演進以及建立實用文件，涵蓋整個API生命週期。本書將眾多實務者的集體智慧整合為44個API設計模式，使用背景、優缺點、概念解決方案及具體範例來解釋，並以兩個不同產業的專案，就領域模型、執行案例、決策敘事及套用模式作一致性解釋，使這些設計模式更易理解。 ‧以設計模式識別及克服API設計挑戰 ‧合理擴增API端點及服務 ‧設計請求和回應訊息的形式 ‧提升訊息設計品質 ‧API演進計畫 ‧API文件撰寫及溝通 ‧結合設計模式以解決實際問題，並做出最佳取捨 撰寫本書的團隊是架構師和開發人員的黃金組合，由經驗豐富的產業專家、模式社群領導者，以及學界研究員與講師所組成。作者們忠實地運用模式概念，將從包含設計力的問題情境中帶往概念性解決方案，包括具體的範例以及相關的模式建議。 許多模式都透過模式會議的指導與寫作者研討會，漸進且反覆地改善與加強，從中凝聚眾人知識得到結論。 本書提供多種API設計空間觀點，從規模與架構到訊息表現結構和品質屬性驅動設計，再到API演進。其模式語言可透過不同的途徑來瀏覽，包括專案階段和結構元素。全書分以五種類別共介紹44種模式，每個模式都有專屬的圖示幫助表達其本質，用作為助記符號及描繪API與其元素。 本書在提供決策模型中採取了獨特且新穎的一步，蒐集關於應用程式的重複出現問題、選項及標準，提供逐步、容易遵循的設計指南，且不會過度簡化API設計固有的複雜性。 本書結合理論與豐富的實務經驗為基礎，包含大量有價值的深刻建議而不失大局，並以學術性的嚴謹和從業人員社群的回饋方式記錄。不論是現在或是未來，與API設計與演進有關的研究、開發及教育的API設計人員，都將從模式中獲益。 【目錄】 叢書編輯 Vaughn Vernon推薦序 Frank Leymann推薦序 前言 致謝 關於作者 Part 1 基礎及敘事 第1章 應用程式介面（API）基礎 從本地介面到遠端API API 設計中的決策驅動要素 遠端API領域模型 第2章 Lakeside Mutual案例研究 業務背景及需求 架構概觀 API設計活動 API規範目標 第3章 API決策敘事 序幕：以模式作為決策選項，力量作為決策準則 基礎API決策與模式 API角色及職責決策 選擇訊息表現模式 插曲：Lakeside Mutual案例的職責及結構模式 治理API品質 API品質改善決策 API演進決策 插曲：Lakeside Mutual案例的品質及演進模式 Part 2 模式 第4章 模式語言介紹 定位及範圍 模式：原因及方法 模式導覽 基礎：API 可見性與整合類型 基本結構模式 第5章 定義端點型態與操作 API角色與職責介紹 端點角色（又稱服務粒度） 操作職責 第6章 設計請求與回應訊息表現 訊息表現設計介紹 元素刻板 特殊目的表現 第7章 改善訊息設計品質 API品質介紹 訊息粒度 客戶端驅動訊息內容（即：回應塑形） 訊息交換最佳化（即：溝通效率） 第8章 演進 API API演進介紹 版本控制和相容性管理 生命週期管理保證 第9章 API規約文件與傳達 API文件介紹 文件模式 Part 3 模式實戰（現在和過去） 第10章 真實世界的模式故事 瑞士抵押貸款業務的大規模業務流程整合 建築營造業的報價和訂單處理 第 11 章 結論 簡短回顧 API研究：模式重構，MDSL及更多 API的未來 其他資源 最終備註 附錄A 端點識別與模式選擇指南 附錄B Lakeside Mutual案例實現 附錄C 微服務領域特定語言（MDSL）