GetMyBot 知識庫

API 快速入門

讓程式列出你的機器人並建立反應:取得存取權杖,使用 curl 傳送第一個請求。

本頁內容

API 讓你的程式在 GetMyBot 讀取機器人、建立反應及取得資料。本例供整合開發者使用;一般的機器人設定請使用視覺化編輯器。

先建立存取用的個人權杖,再向所需操作的網址(端點)傳送 HTTP 請求。以下指令在終端機中以 curl 執行。請把 https://你的網域 換成你的 GetMyBot 安裝網址。

步驟 1:建立個人權杖

在帳號的個人權杖區建立新權杖(PAT)。請立即複製:完整權杖只顯示一次,以 mbp_ 開頭。建立時選擇操作所需的權限範圍(scopes),詳見授權指南。

步驟 2:基本網址與格式

REST 端點通常位於 /api 路徑下,沒有統一的路徑版本號。請求與回應使用 JSON;有內容的請求須提供 Content-Type: application/json。使用 Authorization: Bearer <個人權杖> 標頭,將 <個人權杖>(含尖括號)整段換成以 mbp_ 開頭的完整值,不用另外加一次 mbp_。

步驟 3:讀取機器人清單

使用 bots:read(或 *)權限檢查權杖:

curl -H "Authorization: Bearer <個人權杖>" https://你的網域/api/bots

回應為機器人的 JSON 陣列。權杖無效或過期時,回傳 401 和 {"error":"..."};詳見錯誤。

步驟 4:建立第一條反應

會改變資料的請求稱為修改操作。下例會在所選機器人中建立反應,請只在確實需要該反應的專案執行。須有 reactions:write 權限,並把 BOT_ID 換成上一步的機器人 ID:

curl -X POST https://你的網域/api/bots/BOT_ID/reactions \
  -H "Authorization: Bearer <個人權杖>" \
  -H "Content-Type: application/json" \
  -d '{"name":"歡迎","trigger":{"type":"command","value":"/start"}}'

成功時回應會包含新反應及其 id。請求內容的確切欄位以互動式參考文件為準;每個端點都有 curl、JavaScript 和 Python 範例。

步驟 5:查閱其他端點

權杖可用後,在互動式參考文件查詢 API 網址、所需權限、請求欄位,並可用 Try it 試呼叫。

第一個 Managed AI 請求

建立具有 managed_ai:invoke 權限的 PAT。Idempotency-Key 用來區分操作:重試同一請求時保留相同鍵與內容,新操作使用新鍵。

curl -X POST https://你的網域/api/v1/ai/responses \
  -H "Authorization: Bearer <個人權杖>" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: ai-demo-0001" \
  -d '{"profile":"balanced","provider":"auto","input":[{"role":"user","content":[{"type":"input_text","text":"請簡要總結這段對話"}]}],"max_output_tokens":300}'

若整合介面提供 Managed AI 或 Meta 功能,應先查詢 /api/public/capabilities,確認該安裝環境是否啟用。功能未啟用並非網路故障;請隱藏功能或顯示不可用狀態。

下一步