Beginner Friendly · 零基礎白話版

API 是什麼?
其實你每天都在用它

一句話:API 就是幫兩個程式互相「點餐」的服務生。你不用懂廚房怎麼運作,只要會看菜單、開口點餐,餐點就會送到你面前。

閱讀時間約 8 分鐘 · 完全不需要程式背景 · 內含可以動手玩的小模擬器

01 · THE RESTAURANT

先別管英文縮寫,我們先去餐廳

想像你走進一間餐廳,坐下來想吃一碗牛肉麵。

你不會自己衝進廚房、翻冰箱、開瓦斯爐——你只要跟服務生說「我要一碗牛肉麵,不要辣」。服務生把你的需求傳到廚房,廚房做好之後,服務生再把麵端回來給你。

🍜 這整套流程,就是 API 在做的事

「你」是手機上的 App,「廚房」是遠方某台存著資料的電腦(伺服器),而 API 就是中間那位服務生:負責聽懂你的需求、傳話給廚房、再把結果端回來。你完全不需要知道廚房長什麼樣子。

下面這個小模擬器,你可以親手「點餐」一次,看看資料是怎麼跑的:

▼ API 餐廳模擬器:點一道菜試試 ▼
📱
你的 App
Client 客戶端
📝
🤵
API 服務生
傳話 + 端菜
📝
🏭
廚房
Server 伺服器
👆 按一個按鈕,送出你的「點餐單」
你看到的(App 畫面)
API 實際回傳的(程式看的)

        

注意到了嗎?右邊那串看起來像亂碼的東西,是 API 回傳給程式看的「原始餐點」(格式叫 JSON);App 收到後會把它變成左邊那種人類看得懂的漂亮畫面。API 服務的對象是程式,不是人——這是它跟一般網頁最大的差別。

02 · THE NAME

好,現在來拆解這三個字母

API 是 Application Programming Interface 的縮寫,中文叫「應用程式介面」。聽起來很硬,拆開來其實很好懂:

A
Application
應用程式
就是各種軟體:手機 App、網站、遊戲……都算。
P
Programming
程式
表示這是「給程式用的」,不是給人直接操作的。
I
Interface
介面(窗口)
兩方交流的「窗口」。就像櫃檯、就像菜單。

合起來:「讓應用程式之間互相溝通的窗口」。餐廳的菜單就是一種介面——它規定了你能點什麼、怎麼點;API 也一樣,它規定了程式能要什麼資料、要怎麼開口。

03 · IN YOUR POCKET

你今天可能已經用過十次 API 了

API 不是工程師的專利,它藏在你每天的手機裡:

💡 看出共通點了嗎?

每一個例子都是:「我不自己做這件事,我去跟專門做這件事的人『點餐』。」天氣找氣象局、付款找金流公司、地圖找 Google。API 讓軟體世界可以分工合作——這就是為什麼現代 App 能又快又便宜地做出來。

04 · THE ORDER SLIP

一張「點餐單」的解剖圖

程式跟 API 點餐時送出的東西叫 Request(請求),API 端回來的東西叫 Response(回應)。把它想成點餐單和出餐就好:

📝 Request 點餐單

去哪間店weather.gov.tw→ 網址(要找哪個 API)
點什麼今天的天氣→ 要哪種資料
備註地點=台北→ 參數(細節條件)
會員卡卡號 ab12…→ API 金鑰(證明你有資格點)

🍽️ Response 出餐

出餐狀態200 成功上菜!→ 狀態碼(200=成功)
餐點內容晴,31°C,降雨 10%→ 資料本體(JSON 格式)

如果點了菜單上沒有的東西,服務生會回「404:查無此菜」——對,就是你看過的那個 404。

所以下次看到網頁出現「404 Not Found」,你可以優雅地說:喔,服務生說廚房沒有這道菜。

05 · WHY IT MATTERS

為什麼大家這麼愛用 API?

① 不用知道廚房怎麼運作

你點牛肉麵時,不需要知道湯頭熬了幾小時。同樣地,App 跟氣象局要天氣時,不需要知道對方的衛星和超級電腦怎麼運作。把複雜的事包起來,只留一個簡單的窗口——這叫「封裝」,是 API 最迷人的地方。

② 廚房翻新,菜單不變

餐廳換了新爐子、新主廚,你的點餐方式完全不變。只要「菜單(API 規格)」不變,廚房內部怎麼升級都不影響客人。這讓不同公司、不同系統可以放心地互相合作。

③ 保護廚房安全

客人不能隨便闖進廚房,是為了衛生與安全。API 也一樣:它只開放「該給的資料」,其他一概擋住。加上「會員卡」(API 金鑰)機制,還能控制誰可以點、一天最多點幾次。

06 · FAQ

新手最常見的四個疑問

API 是一個軟體嗎?我要去哪裡下載?

API 不是你下載的軟體,它比較像一份「服務約定」——某家公司說:「你照這個格式問我,我就照這個格式回答你。」實際使用它的是工程師寫的程式,一般使用者是間接享受到它的好處。

API 金鑰(API Key)是什麼?

就是「會員卡」。很多 API 需要先申請一組鑰匙,點餐時出示,對方才知道你是誰、有沒有付費、今天點了幾次。所以金鑰要保管好——就像你不會把會員卡隨便借人,不然帳單算在你頭上。

常聽到「串 API」,是在串什麼?

「串接 API」就是工程師把自己的程式跟別人的 API 接起來,讓兩邊可以通話。例如把公司網站「串」金流 API,網站就有刷卡功能了。串接的過程,本質上就是教程式怎麼看菜單、怎麼點餐、怎麼收餐。

那 REST API、JSON 又是什麼?需要懂嗎?

現階段知道概念就夠:REST 是目前最流行的一種「點餐禮儀」(大家約定好的溝通規則);JSON 是最常見的「餐點包裝格式」(就是模擬器右邊那種大括號文字)。你不需要會寫,只要聽到時知道它們在講什麼層面的事。

07 · QUIZ

三題小測驗,看看你懂了沒

Q1. 用餐廳比喻,API 最像哪個角色?
Q2. 天氣 App 為什麼能顯示天氣?
Q3. 網頁出現「404」,用比喻來說是什麼意思?
08 · RECAP

帶走這五句話就夠了

今日重點

  • API 是程式之間的「服務生」:幫忙傳需求、端回結果。
  • API 服務的對象是程式,不是人;人看到的是 App 加工後的畫面。
  • 送出的需求叫 Request,回來的結果叫 Response,404 就是「查無此菜」。
  • API 金鑰=會員卡,證明身分、控制用量,要保管好。
  • API 讓軟體世界能分工合作:天氣找氣象局、地圖找 Google、付款找金流。