~/VibeHandbook
免費 PDF

04 · 01

API 究竟是什麼

理解 最乾淨的方式,就是把它看成一個程式向另一個程式提供的一份請求選單

餐廳不會讓你直接走進廚房自己做菜。它給你一份選單:這是你能點的東西,這是點菜的方式,這是你會拿到的東西。你不需要知道廚房是怎麼運作的,你只需要這份選單。API 正是如此——一家公司說"這是你被允許向我們服務發出的請求,這是每個請求會返回的東西。"

當 AI 寫出"呼叫天氣 API"的程式碼時,它就是在照著那份選單點單:*把這個城市的天氣預報給我。*天氣公司的伺服器幹活,然後把答案遞回來。你的應用永遠看不到他們的資料庫或程式碼,它只拿到那道菜。

   ┌────────────┐   請求: GET /forecast?city=London   ┌────────────┐
   │  你的應用  │ ──────────────────────────────────▶ │    API     │
   │  (客戶端)  │                                     │    端點    │
   │            │ ◀────────────────────────────────── │  (伺服器)  │
   └────────────┘   響應: { "temp": 14, ... } (JSON)  └────────────┘
      照著選單                                  幹活,
      點餐                                      上菜

最重要的思維轉變是:API 是一份契約。對方公司承諾,只要你按特定方式提問,就會得到特定形狀的答案。你的工作——也是 AI 的工作——就是正確地提問、並正確地讀懂答案。大多數 API 的 bug,都是某一方違背了這份契約。

想離線閱讀?

免費下載整本書的 PDF 或 EPUB。