
0人評分過此書
Web API設計原則:API與微服務傳遞價值之道
內容簡介:《Web API設計原則》涵蓋了在設計API時的原則與流程,透過書中的準則,帶領讀者設計出高成效的API,作者首席顧問James Higginbotham具有豐富的實戰經驗,帶領您與團隊成員建立共識,並設計出高價值的API,並將此設計流程從小團隊擴展到全組織。
作者從「從外向內」(outside-in)的視角檢視API設計,聆聽來自用戶與產品團隊的意見,彙整外部需求,並根據外部需求進行API設計,並確保API的架構條理分明,也談到如何選擇合適的API風格進行實作,書中透過一個實際的案例,為打算設計新API或擴展現有API的人員提供指導。
‧用正確的設計流程交付出色的API
‧為設計團隊、用戶及其他成員建立共同的目標
‧製作工作故事(job story)、進行事件風暴(EventStorming)與建構數位能力(digital capability)模型
‧正確的釐清需求,並歸納成格式一致的API Profile
‧從REST、gPRC、GraphQL、event-based async API(事件式的異步API)等數種API風格中挑選最佳實現方案
‧從文檔編寫人員、測試人員和客戶的反饋改進設計
‧將API解構成微服務
‧累積API經驗與策略,實現可擴展的設計與管理流程
不論你是架構師、開發者、團隊領導人、團隊經理,或是任何提供「API-as-a-product」(API即產品)的技術或商業人士,凡是與API規劃或建構有關的人士,本書對您會是相當有價值的參考資料。
作者從「從外向內」(outside-in)的視角檢視API設計,聆聽來自用戶與產品團隊的意見,彙整外部需求,並根據外部需求進行API設計,並確保API的架構條理分明,也談到如何選擇合適的API風格進行實作,書中透過一個實際的案例,為打算設計新API或擴展現有API的人員提供指導。
‧用正確的設計流程交付出色的API
‧為設計團隊、用戶及其他成員建立共同的目標
‧製作工作故事(job story)、進行事件風暴(EventStorming)與建構數位能力(digital capability)模型
‧正確的釐清需求,並歸納成格式一致的API Profile
‧從REST、gPRC、GraphQL、event-based async API(事件式的異步API)等數種API風格中挑選最佳實現方案
‧從文檔編寫人員、測試人員和客戶的反饋改進設計
‧將API解構成微服務
‧累積API經驗與策略,實現可擴展的設計與管理流程
不論你是架構師、開發者、團隊領導人、團隊經理,或是任何提供「API-as-a-product」(API即產品)的技術或商業人士,凡是與API規劃或建構有關的人士,本書對您會是相當有價值的參考資料。
- 編輯序
- 推薦序
- 前言
- 致謝
- 關於作者
-
Part I 初探Web API 設計
-
第一章API 設計原則
-
Web API 設計要素
-
API 設計=溝通與交流
-
檢視軟體設計原則
-
Resource-Based API 設計
-
資源≠物件或領域模型
-
在Resource-Based API 交換資訊
-
Web API 設計原則
-
總結
-
-
第二章 API 設計與團隊合作
-
為什麼需要API 設計流程?
-
API 設計流程的反模式
-
「API 設計優先」方法
-
「API 設計優先」與敏捷開發
-
ADDR 流程
-
DDD 在API 設計中的角色
-
API 設計與全員參與
-
有效的實施流程
-
總結
-
-
-
Part II 尋求一致性
-
第三章 鑑別數位能力
-
確保參與者的共同目標
-
什麼是「數位能力」?
-
聚焦在JTBD
-
什麼是工作故事?
-
工作故事的結構
-
寫出API 的工作故事
-
工作故事中的挑戰
-
撰寫工作故事的技巧
-
實際的API 設計案例
-
工作故事範例
-
總結
-
-
第四章 產生活動與步驟
-
從工作故事產生活動與步驟
-
利用事件風暴求出共識
-
事件風暴怎麼玩?
-
事件風暴的好處
-
舉辦一場事件風暴
-
總結
-
-
-
Part III 定義API
-
第五章 界定API 邊界
-
避免API 邊界的反模式
-
有界語境、子領域與API
-
用事件風暴界定API 邊界
-
用活動界定API 邊界
-
API 的命名與範圍
-
總結
-
-
第六章 建立API 模型
-
什麼是API 模型?
-
API 建模流程
-
用時序圖驗證API 模型
-
評估API 優先度與重用性
-
總結
-
-
-
Part IV 設計API
-
第七章 REST API 設計
-
什麼是REST API?
-
REST API 設計流程
-
決定API 的表現格式
-
常見的REST API 設計模式
-
總結
-
-
第八章 RPC 與Query-Based API 設計
-
什麼是RPC API ?
-
RPC API 設計流程
-
什麼是Query-Based API ?
-
Query-Based API 設計流程
-
總結
-
-
第九章 異步API
-
輪詢的問題
-
帶來新局的異步API
-
檢視收發訊息的本質
-
異步API 風格
-
設計異步API
-
撰寫異步API 文件
-
總結
-
-
-
Part V 優化API 設計
-
第十章 從API 到微服務
-
什麼是微服務?
-
用微服務降低協作成本
-
API 與微服務的差異
-
衡量微服務的複雜度
-
微服務的同步與異步
-
微服務架構風格
-
穠纖合度的微服務
-
將API 解構成微服務
-
轉換成微服務時的考量
-
總結
-
-
第十一章 優化開發體驗
-
建立擬真API
-
提供輔助套件與SDK
-
提供CLI 工具
-
總結
-
-
第十二章 API 測試策略
-
驗收測試
-
自動化安全測試
-
運行監控
-
API Contract 測試
-
能加速測試的工具
-
API 測試的挑戰
-
建立API 測試的必要性
-
總結
-
-
第十三章 撰寫API 設計文件
-
API 文件的重要性
-
API 描述文件的格式
-
在文件添加範例程式
-
從文件進化成開發者網站
-
有效的API 文件
-
開發者網站的MVP
-
建立開發者網站的工具與框架
-
總結
-
-
第十四章 API 的改版規劃
-
改版對API 帶來的衝擊
-
API 版次策略
-
API 的退場
-
建立API 穩定性聲明
-
總結
-
-
第十五章 API 防護
-
潛在的危害
-
API 防護機制
-
API 防護元件
-
API 閘道拓撲
-
IAM
-
自行建置API 閘道前的考量
-
總結
-
-
第十六章 繼續在API 設計的航道上
-
建立API 風格指南
-
進行API 設計檢討
-
發展重用文化
-
從起點展望未來
-
-
- 附錄 HTTP 入門
- 索引
- 出版地 : 臺灣
- 語言 : 繁體中文
評分與評論
請登入後再留言與評分