Agentic Research

API(應用程式介面)

又稱:API 是什麼 · 接口 · REST API · endpoint · API 端點

一份公開的約定:你照規定的格式發請求過去,對方照規定的格式回結果。你不需要知道對方內部怎麼做。

你會在什麼時候遇到它

你用 AI 的每一步幾乎都在呼叫 API:工具向模型 API 要文字,agent 向搜尋 API 要結果,你的腳本向模型 API 要答案。認得 endpoint、請求、回應、狀態碼這幾個詞,錯誤訊息才從天書變成可以拿去查的線索。

打個比方

像餐廳的菜單加上點餐規矩:你不必進廚房,只要照菜單上的名字點,廚房照規矩把菜送出來。廚房內部怎麼改你不用管 —— 但菜單上的名字一改,你原本那句點法就失效了。

最小範例

# 需要網路。這兩行都不用登入、不用 key,可以直接跑
curl -s https://api.github.com/zen
# → 一句隨機格言,例如 Favor focus over features.

curl -s https://api.github.com/repos/ollama/ollama | head -6
# → {
#     "id": 658928958,
#     "node_id": "R_kgDOJ0Z1Pg",
#     "name": "ollama",
#     ...
#   一段 JSON

兩行都是「呼叫 API」:網址就是 endpoint,curl 發出的請求不用任何身分就能得到回應。真實的 AI API 長得一樣,只是要多加一個 API key,而且回傳的是一大段 JSON,你得從裡面挑出要的那個欄位。

最常搞錯的地方

  • 把 API 想成「一個網站」或「一個檔案」。它是一份格式約定:網址、請求方法、要帶哪些欄位、回傳長什麼樣。四樣有一樣不對就會失敗,而錯誤訊息通常只講其中一樣。
  • 看到 401/403 就以為是對方 API 壞了。這兩個幾乎都是「身分」問題:key 沒帶、帶錯、或那把 key 沒有這個權限。5 開頭的狀態碼才是對方那邊出問題。

相關詞條

下一步