外觀
新增連線選自訂 API(HTTP),要接的是有 REST API 的系統,例如訂單、會員、庫存服務。 憑證設定一次,底下可以掛多個端點(動作)。
連線層的設定
主機位址——只填到主機,例如 https://api.example.com。路徑與 GET/POST 等方法 屬於各個動作,不寫在這裡。
驗證方式——五選一:
- 無——不需要驗證的公開 API。
- Bearer——最常見,token 放在
Authorization: Bearer {token}。 - 自訂 Header——token 要放進特定 header 名稱,例如
X-API-Key。 - 查詢字串——token 要放進網址的查詢參數,例如
?api_key=xxx。政府開放資料與 不少舊系統是這種做法。 - Basic——帳號密碼。
已經存過的密碼欄位會留白顯示提示文字,留白代表沿用原值,要換掉才需要輸入新的。
預設 Header/查詢參數——這裡填的會套用到底下每一個動作,適合放共用的東西 (例如固定的 Content-Type),單一動作才需要的參數填在動作自己的設定裡就好, 不要為了一個動作把它放進預設值,那樣會影響到其他動作。
動作怎麼填
每個動作是一支獨立的 API 呼叫:
方法與路徑——路徑裡可以用 {參數名稱} 當佔位符,例如 /v1/orders/{order_id}。 系統會自動抓出路徑、header、查詢參數、body 裡出現的每一個 {...} 佔位符,列在 模型看到的參數那一區,讓你替每個參數補一句說明——這段說明是 AI 判斷「這個 參數該填什麼」的依據,不是給人看的註解。
Body 類型——無 / JSON(Raw)/ form-data / x-www-form-urlencoded 四選一,JSON 可以直接在 body 裡的字串也放 {參數名稱} 佔位符。
改完路徑或 body 記得看一下模型參數那一區有沒有更新——大部分情況會自動重新 掃描,如果沒有,按重新整理手動抓一次。