API(應用程式介面)是應用程式之間的橋樑,它定義了各種軟體組件如何互相通信和互動。API 提供了一套規範,允許不同的應用程式之間共享資料和功能,使它們能夠彼此協作,實現各種任務和操作。
用麥當勞點餐機來舉個例子,你站在一台點餐機面前,點一個大麥克餐,在其中就蘊含了 API 的運作方式。
在麥當勞的訂單系統中,API的運作方式可以這樣解釋:
請求(Request): 一位顧客(客戶端)透過訂餐應用程式向麥當勞的訂單系統(伺服器)發送一個請求。這個請求可能是「獲取」(GET)菜單資訊的請求,包括食品種類、價格等。請求中包含了操作動作(GET)、菜單的識別符號(例如URL),以及用戶的身份驗證信息(可能是註冊時獲得的API金鑰)。
處理: 麥當勞的訂單系統接收到請求後,根據API的規範,例如檢查用戶的身份驗證信息,然後讀取菜單資料庫,取得相對應的菜單信息。
回應(Response): 處理完請求後,訂單系統向訂餐應用程式發送一個回應。回應中包含了狀態碼,比如200表示成功,以及所請求的菜單資訊,例如各種食品的名稱、價格等。此外,可能還包含額外的元資料,如分頁資訊(如果用戶查詢的菜單過多)或錯誤訊息(如果發生了錯誤)。
解析: 訂餐應用程式接收到回應後,會解析回應的內容,然後在用戶界面上顯示所獲得的菜單信息。用戶可以看到菜單,選擇想要的食品,並提交訂單。同時,訂餐應用程式可能會進一步處理這些訂單,例如處理支付,並向用戶顯示訂單的狀態。