前言

現代應用程式無所不在，從手機 App、網頁服務，到 IoT 裝置，背後都依靠 API（Application Programming Interface） 互相溝通。
如果沒有 API 的幫助，系統就會像「各說各話」的孤島，難以整合、呈現出完整的狀態。

什麼是 API？

• 定義：Application Programming Interface，應用程式介面。
• 角色：讓不同程式或系統之間「標準化」地交換資料。
• 比喻：
  • 像是餐廳的「菜單」，你點的餐（請求）會交給廚房（伺服器），最後送回餐點（回應）。
  • 你不需要知道廚房如何運作，只要透過 API 規範好的方式下單就好。

為什麼要學 API？

1. 工程師必備技能：不管前端、後端、行動開發都會用到 API。
2. 系統整合：企業級服務（ERP、CRM、醫療系統）都靠 API 串接。
3. 開發效率：不必重造輪子，可以直接使用第三方 API（Google Maps、OpenAI、LINE Bot）。
4. 未來趨勢：API Economy（API 經濟）正在興起，許多公司靠提供 API 服務營利（如 Stripe、Twilio）。

API 的主要類型

1. REST (Representational State Transfer)

• 目前最常見的設計風格
• 使用 HTTP 方法（GET、POST、PUT、DELETE）
• 資源導向，回傳 JSON 為主

2. SOAP (Simple Object Access Protocol)

• 以 XML 為基礎，早期常用於金融、電信等系統
• 結構嚴謹，安全性高，但較複雜

3. GraphQL

• Facebook 開發的新型 API 查詢語言
• 由客戶端決定要哪些資料，避免 REST 過度或不足回應的問題

實際生活中的 API 案例

• 天氣 App：透過氣象 API 取得即時天氣
• LINE Bot / Telegram Bot：利用 Messaging API 與用戶互動
• 串接金流：使用 Stripe/藍新 API 完成線上付款
• ChatGPT / Gemini：其實就是「AI API」

小結

• API 是軟體世界的「溝通語言」
• 學習 API，等於掌握「整合不同服務」的能力
• 從今天開始，我們將逐步探索 API 的設計原則、文件工具（Swagger）、測試方法（Postman）、實作框架（FastAPI），最後進入醫療領域的 FHIR API