ianhuang筆記THE ADVENTURER'S JOURNAL
知識世界・持續探索中

ADVENTURE JOURNAL · 探索筆記

前後端分離:API 契約、部署與成本

任務導覽 TABLE OF CONTENTS

保留架構比較,補上契約例子、驗證責任與匯入判斷。

適用:瀏覽器應用與HTTP API的架構規劃,不侷限單一前端框架。

工作方式

前端負責互動與呈現,後端負責業務、持久化與許可權,透過HTTP等契約協作。可分別建置與部署,但不一定必須是SPA,也不必分成不同網域;SSR與同源反向代理也能有清楚邊界。

契約示例

{"tasks":[{"id":"7","title":"整理筆記","updatedAt":"2026-10-06T04:00:00Z"}],"page":1,"pageSize":10,"total":1}

這是假資料,不代表真實API。雙邊需約定分頁從1還是0、日期時區、缺值/錯誤格式與欄位相容策略。後端改變tasks為items是介面變化,不只是自家程式重構;OpenAPI與契約測試幫助發現差異。

優點與成本

前端靜態資源可獨立更新,API可按負載擴充套件,依明確契約可平行開發。代價是多元件部署、CORS/Cookie/token策略、版本協作與端到端觀測。CORS只控制瀏覽器跨源訪問,不是後端認證;所有API仍驗證許可權與輸入。

小團隊簡單內容站未必需要額外API,採用分離不是必然效能較好。先辨識產品生命週期、多人協作與獨立釋出需求,再選框架與部署方式。

驗證

從空環境建立前端與後端,測登入/過期、正常與錯誤響應、網路失敗、舊客戶端與新API相容、直接開子路徑。串聯trace/request ID便於跨層查錯,不能只有前端200截圖。

參考資料

冒險者留言

comments powered by Disqus

搜尋筆記

輸入關鍵字,探索所有筆記。

ESC 關閉 · 搜尋標題、標籤與文章全文