API 設計
6 篇文章
API 設計風格全景對決：RESTful vs. gRPC vs. GraphQL vs. Webhook 深度選型指南
深度拆解現代分散式系統中 4 大主流 API 通訊風格：資源導向 RESTful、二進位高效能 gRPC、宣告式按需查詢 GraphQL 與事件驅動反向推送 Webhook。傳輸效率、N+1 查詢問題、Schema 強型別約束與企業級通訊選型決策樹全景。
REST 與 GraphQL 怎麼取資料？先看懂請求，再比較來回次數
用同一份使用者姓名與文章標題，拆開 HTTP 請求、REST 資源、GraphQL 欄位選擇與 resolver。比較的是 API 契約，而不是把一次網路請求誤認成一次資料庫查詢。
API 版本控制與平滑演進策略：URI Path、Header、Query Param 與破壞性變更相容性治理
比較 4 種主流 API 版本控制策略（URI Path / Custom Header / Content Negotiation Accept / Query Parameter）的優缺點，整理哪些變更向後相容（Backward Compatibility）、哪些會破壞舊客戶端，以及 Stripe 用版本變更模組逐版轉換回應的做法。
API 自動化測試與合約測試架構：消費者導向合約測試（Pact）、模糊測試（Fuzzing）與 Mock 體系
深度剖析微服務與 API 平台工程的高質量交付保證：從 Provider State 資料解耦、Pact Broker 與 can-i-deploy 發布矩陣、事件驅動架構（Message Pact）到狀態感知 Fuzzing 與 Property-Based Testing 實戰指南。
企業級 Webhook 系統架構設計：HMAC-SHA256 簽名驗證、指數退避重試、死信隊列與流量治理
深度剖析現代 SaaS 與金融平台（如 Stripe、GitHub、Shopify）的 Webhook 發送引擎架構：生產級事件發布與非同步投遞管線、HMAC-SHA256 簽名防篡改、帶隨機抖動的指數退避重試演算法（Exponential Backoff with Jitter）、死信隊列（DLQ）與租戶級發送速率治理實戰。
API 分頁架構設計：Offset 分頁 vs. Keyset / Cursor 游標分頁深度對決與效能極限
深入剖析大規模資料庫與 API 分頁架構：深度分頁 (Deep Pagination) 效能崩潰原因、MySQL InnoDB B+ Tree 葉節點全掃描成本、資料動態漂移 (Data Drift) 問題、Keyset / Cursor 游標分頁索引直接尋址與不重複排序鍵 (Tie-breaker) 實戰。