資料與 API詞條 1-41

API

也常叫做:介面、串接(動詞,台灣工程圈口語)、Web API

你可能會這樣說

我想讓網站自動顯示匯率,大家都說「去串 API」——串是什麼意思?

白話解釋

API 是程式和程式之間約定好的溝通介面。講白一點:別人家的程式開了一個「櫃檯」,你照規定送出請求,它就照規定回你資料。想知道匯率,不用自己每天去銀行抄數字——中央銀行或金融網站提供了 API,你的網站去問,它就答。

串接 API 的動作可以想成:填一張制式表單寄過去,對方回你一張制式回條。表單怎麼填(參數)、回條長什麼樣(通常是 JSON 格式的資料),都寫在對方提供的「API 文件」裡。

跟 AI 協作時,只要說清楚三件事就夠了:用哪一家的 API、想要什麼資料、拿到資料後要顯示在哪裡。如果對方要求金鑰(API Key),記得那是帳密等級的東西,不要貼到公開的地方。

親手試試

USD → TWD —
圖 1-4 按下按鈕,看一次 API 的「一問一答」長什麼樣子。

別搞混

API 這個詞的範圍其實很大,先分清楚你碰到的是哪一種。

Web API(別人提供的服務)

天氣、匯率、地圖、AI 模型……別人開的櫃檯。你去要資料或請它做事,多數照次數收費,需要金鑰。跟 AI 說「串接」的就是這種。

自己網站的 API

你的後端也可以開櫃檯給自己的前端用。會員資料、訂單列表,前端就是靠這種內部 API 拿資料的——只是使用者看不到這層溝通。

這樣對 AI 說

中文就可以
我想在網站首頁顯示「今日匯率(美元兌台幣)」,請幫我串接 API:

1. 請先推薦一個免費、不需要付費就能用的匯率 API,並告訴我它的文件網址。
2. 我已經申請好金鑰,告訴我金鑰要設定在哪裡才安全(不要直接寫死在前端程式碼裡被看到)。
3. 網頁上顯示:幣別、匯率、更新時間三個欄位就好,樣式簡單乾淨。
4. 如果 API 抓不到資料,畫面要顯示「目前無法取得」,不要整頁壞掉。

請先給我完成版,再解釋你做了什麼。

把「金鑰不要暴露」和「失敗時不要壞掉」講在前面,可以擋掉兩個最常見的坑。

延伸閱讀

同一課的其他詞