專注 API 管理、DevOps 整合、自動化測試與軟體品質工程的顧問服務
微服務的「碎片化」惡夢 微服務架構 (Microservices) 的初衷是解耦 (Decoupling),讓每個服務可以獨立開發、獨立部署。這聽起來很棒,但在 API 設計上,這往往演變成一場災難。 試想一下,你們公司有「訂單服務」、「會員服務」和「物流服務」。這三個服務都需要用到 「使用者資料 (User Profile)」。 結果發生了什麼事? Team A (訂單) 定義的 User 有 user_id 和 email。 Team B (會員) 定義的 User 有 uid 和 e-mail (多了一個連字號)。 Team C (物流) 定義的 User 有 id 和 contact_email。 雖然都在講同一個「人」,但欄位名稱完全不同。這導致前端團隊在串接時,必須寫三套不同的邏輯來解析資料。這不叫「獨立」,而是「疊床架屋」(Reinventing the wheel)且製造混亂。 今天我們要聊聊,如何利用 SmartBear Swagger (SwaggerHub) 的 Domains (領域) 功能,來終結這種各自為政的亂象。 什麼是 API Domains (領域模型)? 在寫程式時,我們都知道要把共用的函式抽出來變成 […]