API 文件

Version 1.0 · RESTful API · JSON

概覽

TREKX API 讓您將客戶資料、行程管理與報表功能整合至您現有的 CRM 或內部系統。所有 API 端點均需通過 Bearer Token 驗證。

Base URL

https://api.trekx.ai/v1

所有請求須在 Header 中附加 API Key：

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

POST/api/v1/webhook/line

LINE Messaging API Webhook 接收端點。用於接收旅客發送的訊息並觸發 AI 回覆。

GET/api/v1/leads

取得所有客戶需求列表，支援分頁與篩選。

GET/api/v1/leads/:id

取得單一客戶需求詳情，包含對話紀錄與 BANT 分析。

PATCH/api/v1/leads/:id/status

更新客戶狀態（待跟進 / 已聯繫 / 已成交 / 已關閉）。

GET/api/v1/reports/monthly

取得月度業績報表，包含接客數、轉換率、成交金額。

POST/api/v1/itineraries

建立新行程方案，支援拖曳式編輯與 Google Maps 整合。

API 請求限制為每分鐘 100 次。超過限制時將收到 429 Too Many Requests 回應。 Enterprise 方案可申請提高上限。