04 / 07

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

  1. 定義一個請求需要的 input。
  2. 定義成功 response 的欄位。
  3. 定義至少一種錯誤 response 與處理方式。
10

Ask AI TA