閱讀時間: 5 分鐘
艦隊平台
行動應用程式

建立自訂集成
使用 Zeo API

使用我們的 RESTful API 將您的系統連接到 Zeo。建立路由,
即時追蹤進度,並使用 Webhook 實現工作流程自動化。

Zeo API 和 Webhooks,Zeo 路線規劃器
  • 99.9%

    API 正常運作時間 SLA

  • 100ms

    平均響應時間

  • 20+

    API端點

  • 10K

    每分鐘請求次數限制

開發者平台 功能

將路線規劃整合到您的應用程式中所需的一切

  • Zeo API 和 Webhooks,Zeo 路線規劃器

    REST API

    功能齊全的 RESTful API,用於管理路線、站點、司機等。採用 JSON 請求/回應格式,並附有詳盡的文件。

    • 以程式設計方式建立和優化路線
    • 管理站點、司機和車輛
    • 取得即時追蹤數據
    • 訪問分析和報告
    • 批量操作支持
  • Zeo API 和 Webhooks,Zeo 路線規劃器

    Webhook 事件

    即時事件通知推播至您的端點。立即回應路由變更、停止完成和驅動程式更新。

    • 路線開始/完成事件
    • 停止狀態變更通知
    • 駕駛員位置更新
    • 預計到達時間變更提醒
  • Zeo API 和 Webhooks,Zeo 路線規劃器

    認證

    採用業界標準身份驗證,確保 API 存取安全。提供多種金鑰類型,以滿足不同的存取等級和使用場景。

    • Bearer令牌認證
    • API金鑰管理控制面板
    • 每個金鑰的權限範圍
    • 關鍵輪替支持
    • 每個按鍵的速率限制
  • Zeo API 和 Webhooks,Zeo 路線規劃器

    第三方進口

    無縫匯入外部系統中的訂單和作業。導入時自動進行地址驗證和地理編碼。

    • 批次停止導入端點
    • 地址驗證和地理編碼
    • 自訂字段映射
    • 重複檢測
    • 導入狀態追蹤

網絡掛接 最新活動

訂閱即時事件並對路線變更做出即時反應

  • 幀 1707478314 20 1,Zeo 路線規劃器

    路線已啟動

    當駕駛員開始導航路線時觸發。包含路線 ID、駕駛員資訊和預計完成時間。

  • 框架 1707478314 19,Zeo 路線規劃器

    停止完成

    當站點標記為完成時觸發。包含服務證明資料、時間戳記和備註。

  • 框架 1707478314 17,Zeo 路線規劃器

    停止失敗

    當停靠任務未能完成時發送。包含失敗原因以及任何已拍攝的照片/備註。

  • 組 11880,Zeo 路線規劃器

    驅動程式位置更新

    定期更新活躍駕駛員的位置資訊。更新頻率可配置,範圍從 30 秒到 5 分鐘。

  • 組 11880 1,Zeo 路線規劃器

    eta.已更改

    當預計到達時間因交通或延誤而發生顯著變化時觸發。

  • 組 11880 2,Zeo 路線規劃器

    路線已完成

    當所有站點都完成後觸發。包含最終統計資料、持續時間和效能指標。

  • // Webhook 有效負載範例
    {
      “事件”: “停止完成”,
      “時間戳”: "2024-01-15T14:32:00Z",
      “數據”:{
        "route_id": "route_abc123",
        "stop_id": "stop_xyz789",
        “司機”:{
          “ID”: “drv_456”,
          “姓名”: 約翰史密斯
        },
        “完成於”: "2024-01-15T14:31:45Z",
        “證明”:{
          “簽名”: "https://...",
          “照片”["https://..."],
          “筆記”: “留在門口”
        } } }

    API端點 Overview

    路線規劃和車隊管理的核心端點

    解決方案&帖子
    /v1/路由

    建立包含停靠點和最佳化設定的新路線

    GET
    /v1/routes/{id}

    取得路線詳情,包括優化後的順序

    解決方案&帖子
    /v1/routes/{id}/最佳化

    使用更新後的參數重新優化現有路線

    GET
    /v1/routes/{id}/tracking

    取得目前路線的即時追蹤數據

    解決方案&帖子
    /v1/停止/導入

    停止從外部系統批次匯入

    PUT
    /v1/stops/{id}/status

    更新停止狀態(已完成、失敗、已跳過)

    GET
    /v1/驅動程式

    列出所有可用狀態的司機

    GET
    /v1/drivers/{id}/location

    取得目前位置和路線進度

    解決方案&帖子
    /v1/webhooks

    註冊用於事件通知的 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 通知會即時更新訂單狀態。

    現場服務

    CRM驅動的服務調度

    一家現場服務公司透過 API 將工單從其 CRM 系統同步到現場。新工單會自動建立包含客戶詳細資料、服務要求和時間視窗的網站。工單完成後,Webhook 會更新 CRM 系統並觸發開立發票。

    組 1707478361,Zeo 路線規劃器

    準備建造 您的整合方案?

    取得您的 API 金鑰,並藉助我們全面的文檔,在幾分鐘內開始建置。

    組 1707478363,Zeo 路線規劃器

    澤奧問卷

    頻繁

    問題

    了解更多

    Zeo API 和 Webhooks

    API 速率限制是多少?

    標準 API 金鑰允許每分鐘 1,000 次請求。企業版套餐可申請更高的限制,最高可達每分鐘 10,000 次請求。每次回應中都會包含速率限制標頭,方便您追蹤使用情況。

    如何驗證 API 請求?

    所有 API 請求都需要在 Authorization 標頭中包含 Bearer 令牌。您可以在帳戶設定中產生 API 金鑰。金鑰可以限定於特定權限(唯讀、寫入、管理員)和 IP 位址。

    你們有不同語言的SDK嗎?

    我們提供官方的 JavaScript/Node.js 和 Python SDK。社群維護的 SDK 則適用於 Ruby、PHP 和 Go。所有 SDK 均為開源,並發佈在 GitHub 上。

    webhook重試機制是如何運作的?

    如果您的端點回傳非 2xx 反應,我們將採用指數退避法進行重試:1 分鐘、5 分鐘、30 分鐘、2 小時和 24 小時。 5 次重試失敗後,webhook 將被標記為失敗,您將收到電子郵件通知。

    是否有沙箱環境來測試?

    是的,我們提供完整的沙箱環境,網址是 api-sandbox.zeoroute.com。沙箱環境擁有與正式環境相同的 API,但包含測試數據,而且完全免費。非常適合開發和整合測試。

    所有套餐都提供 API 嗎?

    Zeo REST API 在車隊管理和企業版套餐中均可使用。它包括完整的路線管理、站點操作、駕駛員管理以及用於即時事件通知的 webhook 支援。

    澤奧 博客

    瀏覽我們的博客,獲取富有洞察力的文章、專家建議和鼓舞人心的內容,讓您隨時了解情況。

    2026年01月23日 如何減少檢查行程時間(專題報告:Zeo路線規劃器)

    如何減少檢查行程時間以提高車隊效率

    閱讀時間: 7 分鐘學習行之有效的策略,縮短車隊巡檢行程時間。優化調度、移動協調和路線規劃,降低停機成本。

    2026年01月23日 如何管理多條泳池服務路線(特色內容),Zeo路線規劃器

    如何有效率管理多條泳池服務路線

    閱讀時間: 8 分鐘學習行之有效的策略來管理多條泳池服務路線,減少 30% 的行駛時間,消除漏掃,並盈利地擴展到新的區域。

    如何成為 DoorDash 司機? Zeo 路線規劃器

    如何成為 DoorDash 送餐員?

    閱讀時間: 4 分鐘談到工作,我們都渴望靈活自由。蓬勃發展的零工經濟正是對這一點的真實寫照。