SYSTEM FOUNDATIONS · LESSON 04
API
A contract between systems
用 request / response 看懂系統如何互相溝通,而不是先陷入語法。
LESSON 4 / 7
01
這是什麼?
API 是系統之間約定好的介面與資料契約,定義可以提出什麼請求、得到什麼回應。
02
為什麼需要它?
有契約,系統才能分工;沒有契約,整合就會變成猜測與脆弱的字串拼接。
03
它在整個系統的位置
Frontend ↔ API ↔ Backend / Data Source
這是學習用的概念位置,實際產品會依需求有不同分工與部署方式。
04
用生活情境理解
ANALOGY
像餐廳點餐介面:客人依菜單格式提出需求,廚房依約定回傳餐點或說明無法供應。
05
E.X 真實案例
E.X CASE
Market Radar 的資料載入與分析層把官方資料先 normalize,再讓畫面依固定結構讀取。
06
AI 可以幫你做什麼?
AI CAN ASSIST
協助描述 input / output、產生測試請求與整理錯誤回應,並提醒契約缺口。
07
哪些東西你自己一定要懂?
HUMAN JUDGMENT
要看懂資料型別、錯誤狀態、權限與版本相容性;API 能傳資料,不代表資料自動可信。
08
Knowledge Check
API 最核心的價值是什麼?
查看提示與答案
讓不同系統在清楚的 input / output 契約下協作,降低彼此對內部實作的依賴。
09
Practice
寫一張 API contract card
- 定義一個請求需要的 input。
- 定義成功 response 的欄位。
- 定義至少一種錯誤 response 與處理方式。
10