API 文檔

接入方式概覽

ClawQR 提供三種接入方式，可依團隊的技術能力選擇：

• REST API：批次產生二維碼、建立短連結、取得掃碼與線索資料；
• Webhook 回呼：掃碼、留資等事件發生時推送到你的伺服器；
• MCP 協議：將二維碼 Agent 能力接入支援 MCP 的 AI 客戶端與工作流程。

接入流程

1. 寄送郵件至 contact@clawqr.com，說明公司、業務場景與預估呼叫量；
2. 我們開通測試環境帳號，並提供 API Key 與介面文件；
3. 測試環境聯調通過後切換到正式環境。

API Key 屬敏感憑證，請在伺服器端保存與呼叫，不要寫在前端程式碼或公開儲存庫中。

能力範圍

• 二維碼與短連結：建立、更新目標網址、設定有效期；
• 掃碼事件：掃碼時間、來源渠道、裝置與地區等基礎資訊（不含個人身分資訊）；
• 線索資料：掃碼產生的線索紀錄、跟進狀態查詢；
• Agent 設定：依場景設定問答與話術範本。

請求範例（示例程式碼，正式網域與參數以商務提供為準）

POST /v1/qrcodes
Content-Type: application/json
Authorization: Bearer <YOUR_API_KEY>

{
  "name": "sample-catalog-2026",
  "target_url": "https://example.com/catalog",
  "ttl_hours": 24
}

服務與支援

工作日 9:00 - 18:00（台北時間 UTC+8）。技術對接問題請寄送郵件至 contact@clawqr.com，並附上呼叫時間、介面路徑與錯誤訊息。