---
url: https://docs.oakxgen.ai/zh-Hant-TW/guide/connections/http-connection.md
description: 自訂 API 連線只填一次主機位址與憑證，底下可以掛多個動作，每個動作是一支 API 呼叫。這篇說明驗證方式怎麼選、以及動作裡的路徑參數怎麼寫。
---

新增連線選**自訂 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 記得看一下模型參數那一區有沒有更新**——大部分情況會自動重新
掃描，如果沒有，按**重新整理**手動抓一次。

## 延伸閱讀

[網站客服機器人要怎麼即時查詢訂單狀態，不是每次都要人工查系統](/zh-Hant-TW/article/website-chatbot-order-status-lookup)