行動應用程式
建立自訂集成
使用 Zeo API
使用我們的 RESTful API 將您的系統連接到 Zeo。建立路由,
即時追蹤進度,並使用 Webhook 實現工作流程自動化。
使用我們的 RESTful API 將您的系統連接到 Zeo。建立路由,
即時追蹤進度,並使用 Webhook 實現工作流程自動化。
API 正常運作時間 SLA
平均響應時間
API端點
每分鐘請求次數限制
將路線規劃整合到您的應用程式中所需的一切
功能齊全的 RESTful API,用於管理路線、站點、司機等。採用 JSON 請求/回應格式,並附有詳盡的文件。
即時事件通知推播至您的端點。立即回應路由變更、停止完成和驅動程式更新。
採用業界標準身份驗證,確保 API 存取安全。提供多種金鑰類型,以滿足不同的存取等級和使用場景。
無縫匯入外部系統中的訂單和作業。導入時自動進行地址驗證和地理編碼。
訂閱即時事件並對路線變更做出即時反應
當駕駛員開始導航路線時觸發。包含路線 ID、駕駛員資訊和預計完成時間。
當站點標記為完成時觸發。包含服務證明資料、時間戳記和備註。
當停靠任務未能完成時發送。包含失敗原因以及任何已拍攝的照片/備註。
定期更新活躍駕駛員的位置資訊。更新頻率可配置,範圍從 30 秒到 5 分鐘。
當預計到達時間因交通或延誤而發生顯著變化時觸發。
當所有站點都完成後觸發。包含最終統計資料、持續時間和效能指標。
// Webhook 有效負載範例 { “事件”: “停止完成”, “時間戳”: "2024-01-15T14:32:00Z", “數據”:{ "route_id": "route_abc123", "stop_id": "stop_xyz789", “司機”:{ “ID”: “drv_456”, “姓名”: 約翰史密斯 }, “完成於”: "2024-01-15T14:31:45Z", “證明”:{ “簽名”: "https://...", “照片”["https://..."], “筆記”: “留在門口” } } }
路線規劃和車隊管理的核心端點
建立包含停靠點和最佳化設定的新路線
取得路線詳情,包括優化後的順序
使用更新後的參數重新優化現有路線
取得目前路線的即時追蹤數據
停止從外部系統批次匯入
更新停止狀態(已完成、失敗、已跳過)
列出所有可用狀態的司機
取得目前位置和路線進度
註冊用於事件通知的 webhook 端點
透過您喜愛的語言的範例快速入門
建立並優化包含多個停靠點的路線 curl -X POST "https://api.zeoroute.com/v1/routes" -H “授權:持有者 $ZEO_API_KEY” -H "Content-Type: application/json" -d '{ "name": "早晨配送", "driver_id": "drv_123", "optimize": true, "start_location": { "address": "123 Warehouse St, City" }, "stops": [ { "address": "456 Customer Ave", "time_window" "12:00"}, "service_time": 15 }, { "address": "789 Business Blvd", "priority": "high", "service_time": 30 } ] }' # 取得路線詳情 curl -X GET "https://api.zeoroute.com/v1/routes/route_abc123" -H “授權:持有者 $ZEO_API_KEY” # 更新停止狀態 curl -X PUT "https://api.zeoroute.com/v1/stops/stop_xyz789/status" -H “授權:持有者 $ZEO_API_KEY” -H "Content-Type: application/json" -d '{"status": "已完成", "notes": "已放在門口"}'
自動更新適用於任何有定期巡檢的行業。
電商平台每小時透過 API 自動匯入新訂單。訂單按地區分組,優化路線,並分配給司機。配送完成後,Webhook 通知會即時更新訂單狀態。
一家現場服務公司透過 API 將工單從其 CRM 系統同步到現場。新工單會自動建立包含客戶詳細資料、服務要求和時間視窗的網站。工單完成後,Webhook 會更新 CRM 系統並觸發開立發票。
取得您的 API 金鑰,並藉助我們全面的文檔,在幾分鐘內開始建置。
標準 API 金鑰允許每分鐘 1,000 次請求。企業版套餐可申請更高的限制,最高可達每分鐘 10,000 次請求。每次回應中都會包含速率限制標頭,方便您追蹤使用情況。
所有 API 請求都需要在 Authorization 標頭中包含 Bearer 令牌。您可以在帳戶設定中產生 API 金鑰。金鑰可以限定於特定權限(唯讀、寫入、管理員)和 IP 位址。
我們提供官方的 JavaScript/Node.js 和 Python SDK。社群維護的 SDK 則適用於 Ruby、PHP 和 Go。所有 SDK 均為開源,並發佈在 GitHub 上。
如果您的端點回傳非 2xx 反應,我們將採用指數退避法進行重試:1 分鐘、5 分鐘、30 分鐘、2 小時和 24 小時。 5 次重試失敗後,webhook 將被標記為失敗,您將收到電子郵件通知。
是的,我們提供完整的沙箱環境,網址是 api-sandbox.zeoroute.com。沙箱環境擁有與正式環境相同的 API,但包含測試數據,而且完全免費。非常適合開發和整合測試。
Zeo REST API 在車隊管理和企業版套餐中均可使用。它包括完整的路線管理、站點操作、駕駛員管理以及用於即時事件通知的 webhook 支援。
Zeo 的 API 可讓您以程式設計方式建立路線、管理站點,並將即時追蹤與您自己的系統同步,從而消除重複的手動工作。
Webhook 會將即時事件通知(例如停止完成或路由啟動)推送到您的端點,以便系統可以立即做出反應,而無需輪詢更新。
是的。您可以使用完整的 REST API 將 Zeo 與內部工具、ERP 或自訂應用程式集成,該 API 支援建立實體和檢索詳細資訊。
Webhook 可即時更新路線進度、預計到達時間變更和司機位置,使系統和團隊保持同步,無需手動刷新。
Webhook 用於觸發系統中的事件,例如路線開始、路線結束、司機更新以及其他路線進度。
當然。它們使開發人員能夠自動處理大量路由數據,並隨著業務的成長將 Zeo 深度整合到企業工作流程中。
瀏覽我們的博客,獲取富有洞察力的文章、專家建議和鼓舞人心的內容,讓您隨時了解情況。