場景集
權限管理 下一個儀表板
場景 10 · 開發者

把 MaiGPT / 助理串到自家系統

產 API Key、限定 scope(讀 / 寫 / 管)、設過期日、看每個 key 的用量統計。產出後立刻給 curl / Python / Node.js 範例,10 秒驗證能 call 通。

用 API Key 把 MaiAgent 串到自家系統 — 客服機器人、業務 CRM、營運 dashboard 都可以呼叫。所有 key 嚴格保密、可隨時撤銷。
名稱
Key
Scope
本月呼叫
過期
操作
官網客服 chatbot
2026-01-15 由 Scott 建立
sk_live_•••••a2f4
read write
128,402
2027-01-15
業務 CRM 整合
2026-02-08 由 Felix 建立
sk_live_•••••8c91
read
42,891
無限期
舊版測試 key
疑似洩漏 — 建議撤銷
sk_test_•••••3f7a
admin
3,128 ↑
已過期 12 天
安全提醒 · 系統偵測到「舊版測試 key」連續 24 小時呼叫頻率異常(往常 0 → 突然 3K+),已寄通知給 Scott。建議立即撤銷或限制 IP。 查看用量 →
新增 API Key
行銷 dashboard 串接
建議寫清楚用途,方便日後追溯(例如:官網客服、業務 CRM、報表 dashboard)
30 天 90 天 1 年 永不過期 自訂...
建議設過期日,到期自動撤銷。永不過期需要組織管理員核准。
逗號分隔,支援 CIDR — 不在範圍內的 IP 即使有 key 也無法呼叫。
Key 已產生
這是你唯一一次能看到完整 key · 關閉視窗後僅顯示前後 4 碼。請立即複製並存到密碼管理器(1Password / Bitwarden)。
sk_live_2026R4n7gM8aB6cD9eF0gH3iJ5kL7mN9oP2qR4tU6vW8xY0z2A4b6C8d
名稱
行銷 dashboard 串接
Scope
read chat
過期
2026-08-04(90 天後)
建立者
Scott · scott@maiagent.ai
基本資訊
10 秒測試
用量統計
呼叫紀錄
挑你慣用的語言,貼到 terminal 就能跑 — 確認 key 設定正確。
curl
curl https://api.maiagent.ai/v1/conversations \
  -H "Authorization: Bearer sk_live_2026R4n7gM8aB6cD9eF0gH3iJ5kL7..." \
  -H "Content-Type: application/json" \
  -d '{
    "chatbot_id": "cb_abc123",
    "message": "你好,幫我查訂單狀態"
  }'
回應(200 OK · 412ms)
json
{
  "id": "conv_xyz789",
  "model": "claude-sonnet-4-6",
  "reply": "請提供您的訂單編號(OD-開頭)我可以協助查詢...",
  "latency_ms": 412,
  "tokens": { "in": 14, "out": 23 }
}
設定 Webhook
對話完成自動推到你的系統
完整 API 文件
OpenAPI spec · 30+ endpoints
核心流程
1
看現有 keys
每把 key 顯示用量、scope、過期;異常用量自動 alert(疑似洩漏)。
2
新增 key + 限定範圍
名稱、scope (read / chat / write / admin)、過期日、IP 限制 — 全在 modal 一次設定。
3
一次性顯示
key 只給看一次 — 強制要存到密碼管理器。關閉後僅顯示前後 4 碼。
4
10 秒驗證能 call 通
curl / Python / Node / PHP / Go 範例直接複製貼上跑 — 確認 key + scope 都對。