什麼是 API？

TL;DR

API 就像餐廳的菜單：你不需要知道廚房怎麼運作，只要看菜單點餐，廚房就會把你要的菜做好送出來。

為什麼需要 API？

想像你在使用手機 App 查天氣。你的 App 怎麼知道現在是晴天還是下雨？答案是：它透過 API 向氣象局的伺服器「要資料」。

這就是 API（Application Programming Interface）的核心功能：讓不同的軟體可以互相溝通、交換資料。

生活化的比喻

餐廳點餐

• 你：顧客（使用 App 的人）
• 菜單：API（列出可以點什麼）
• 服務生：API 的執行者（把你的需求傳達給廚房）
• 廚房：伺服器（實際處理你的請求）
• 上菜：回傳結果（你得到想要的資料）

你不需要知道廚房在哪裡、廚師是誰、食材怎麼處理。你只要照著菜單點餐，就能得到想要的食物。

電視遙控器

按下遙控器的「頻道+」按鈕，電視就會換台。你不需要知道電視內部的電路怎麼運作，遙控器就是你和電視之間的「API」。

真實案例

Google Maps 嵌入網站

很多網站都有地圖功能（比如餐廳位置）。這些網站並沒有自己做一套地圖系統，而是使用 Google Maps API：

1. 網站向 Google 說：「我想顯示台北 101 的位置」
2. Google Maps API 回傳地圖資料
3. 網站把地圖顯示在頁面上

第三方登入

當你在某個網站看到「使用 Google 帳號登入」，這就是透過 Google 的登入 API：

1. 你按下「使用 Google 登入」
2. 網站向 Google API 說：「這個人想用 Google 帳號登入」
3. Google 確認你的身份後，告訴網站「這個人是合法用戶」
4. 網站讓你登入成功

你不需要在每個網站都註冊新帳號，就能快速登入。

API 的三個關鍵要素

1. 請求（Request）

「我想要什麼資料？」

例如：「給我今天台北的天氣」

2. 處理（Process）

伺服器收到請求後，去資料庫找資料、計算結果。

3. 回應（Response）

伺服器把結果傳回來。

例如：「台北今天晴天，28°C」

常見疑問

Q: API 是免費的嗎？

不一定。有些 API 是免費的（比如政府的開放資料），有些需要付費（比如 Google Maps API 用量大時要收費）。

Q: 誰可以用 API？

大多數公開的 API 都需要「API Key」（像是一把鑰匙），確保只有經過許可的人才能使用。

Q: API 安全嗎？

正規的 API 都有安全機制（像 HTTPS 加密、身份驗證）。但就像任何網路服務，使用時還是要注意資料安全。

下一步

現在你已經理解 API 的基本概念了！如果你想深入了解：

• 技術層面：學習「REST API」、「GraphQL」等技術細節
• 實作層面：試著用 Postman 工具測試公開的 API
• 決策層面：了解「自己開發 vs 使用第三方 API」的取捨

重點回顧

• API 是軟體之間溝通的橋樑
• 你不需要懂技術細節，就能使用 API 提供的功能
• 生活中到處都是 API：天氣 App、地圖、第三方登入…
• API 讓開發更快速，不用什麼都自己做