Summary

Rick Hwang 以 B2B API First 策略為背景,系統化整理 API 通訊模式與協議選擇。核心框架:將四種系統角色(API Platform、Service X、External Services、Client)之間的 16 種通訊排列組合收斂為 4 個核心情境(Session-Based、External API、Internal Communication、External Invocation),再為每個情境選擇適當的協議和架構設計。

Rick Hwang systematizes API communication patterns and protocol selection under a B2B API-First strategy, reducing 16 possible inter-component communication combinations to 4 core scenarios with appropriate architecture decisions for each.

Key Points

  • 四種系統角色: API Platform(API Gateway + Management + Operation)、Service X(內部 Domain Services)、External Services(B2B 合作夥伴)、Client(End User GUI)
  • 情境矩陣: 四種角色之間有 16 種排列組合,過濾後收斂為 4 個核心情境:Session Base(A2)、External API(B3/C4)、Internal Communication(C3/D3/D4)、External Invocation(C2/D2)
  • API Platform 核心需求: Security、Reliability、Performance、Operational — 對外處理合作夥伴請求、轉發給內部服務
  • API First 的商業本質: 開放 API 是 B2B 策略聯盟,是內部系統高度整合後對外提供的統一介面
  • 生態系哲學: 猶太商人案例寓意 — 透過互補、共榮而非直接競爭,API 生態系的成功在於讓合作夥伴都能從整合中獲利

Insights

情境矩陣的方法論價值在於把「API 設計」從單一技術選擇問題(用 REST 還是 gRPC?)提升為架構分析問題:先確定通訊的角色關係和方向,再決定協議和治理策略。不同情境下的最佳選擇可能完全不同。

「先定義情境,再選協議」的順序在實務中經常被顛倒:工程師先決定用 REST 或 WebSocket,再去套情境。Rick 的框架提醒我們方向應該相反。

API Platform 的三層分離(Gateway/Management/Operation)是成熟企業 API 基礎設施的標準形態,對應 Kong/APIM/Observability 等工具鏈的職責劃分。

Connections

Raw Excerpt

開放 API 是個策略性決策,背後代表著要與合作夥伴達成策略聯盟,本質上是 B2B 的商業行為;同時開放 API 也意味著內部系統需要有高度整合,提供對外統一介面與標準。