Zeo API 和 Webhooks | Zeo 路线规划器 ...
阅读时间: 5 分钟
舰队平台
移动应用程序

构建自定义集成
使用 Zeo API

使用我们的 RESTful API 将您的系统连接到 Zeo。创建路由,
实时跟踪进度,并使用 Webhook 实现工作流程自动化。

Zeo API 和 Webhooks,Zeo 路线规划器
  • 99.9%

    API 正常运行时间 SLA

  • 100ms

    平均响应时间

  • 20+

    API端点

  • 10

    每分钟请求次数限制

开发者平台 产品特性

将路线规划集成到您的应用程序中所需的一切

  • 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端点 概述

    路线规划和车队管理的核心端点

    解决方案&帖子
    /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 端点

    代码 例子

    通过您喜爱的语言的示例快速入门



    创建并优化包含多个停靠点的路线
    卷曲 -X POST "https://api.zeoroute.com/v1/routes" -H “授权:持有者 $ZEO_API_KEY” -H “内容类型:应用程序/json” -d '{ "name": "早间配送", "driver_id": "drv_123", "optimize": true, "start_location": { "address": "123 Warehouse St, City" }, "stops": [ { "address": "456 Customer Ave", "time_window": { "start": "09:00", "end": "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” # 更新停止状态
    卷曲 -X PUT "https://api.zeoroute.com/v1/stops/stop_xyz789/status" -H “授权:持有者 $ZEO_API_KEY” -H “内容类型:应用程序/json” -d '{"status": "已完成", "notes": "已放在门口"}'

    之路 使用案例

    自动更新适用于任何有定期巡检的行业。

    DELIVERY

    订单管理集成

    电商平台每小时通过 API 自动导入新订单。订单按地区分组,优化路线,并分配给司机。配送完成后,Webhook 通知会实时更新订单状态。

    现场服务

    CRM驱动的服务调度

    一家现场服务公司通过 API 将工单从其 CRM 系统同步到现场。新工单会自动创建包含客户详细信息、服务要求和时间窗口的站点。工单完成后,Webhook 会更新 CRM 系统并触发开票。

    组 1707478361,Zeo 路线规划器

    准备建造 您的整合方案?

    获取您的 API 密钥,并借助我们全面的文档,在几分钟内开始构建。

    组 1707478363,Zeo 路线规划器

    常見問題解答

    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 支持。

    我为什么要使用 Zeo API 而不是手动输入数据?

    Zeo 的 API 允许您以编程方式创建路线、管理站点,并将实时跟踪与您自己的系统同步,从而消除重复的手动工作。

    Webhook 为自动化工作流程解决了哪些问题?

    Webhook 会将实时事件通知(例如停止完成或路由启动)推送到您的端点,以便系统可以立即做出反应,而无需轮询更新。

    我可以使用 API 构建自定义自动化流程吗?

    是的。您可以使用完整的 REST API 将 Zeo 与内部工具、ERP 或自定义应用程序集成,该 API 支持创建实体和检索详细信息。

    如何利用网络钩子获取实时数据来改进运营?

    Webhook 可即时更新路线进度、预计到达时间变更和司机位置,使系统和团队保持同步,无需手动刷新。

    Webhook 可以通知我哪些类型的事件?

    Webhook 用于触发系统中的事件,例如路线开始、路线结束、司机更新以及其他路线进度。

    使用 API 和 Webhook 对扩展业务规模有帮助吗?

    当然。它们使开发人员能够自动处理大量路由数据,并随着业务的增长将 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 支持。

    我为什么要使用 Zeo API 而不是手动输入数据?

    Zeo 的 API 允许您以编程方式创建路线、管理站点,并将实时跟踪与您自己的系统同步,从而消除重复的手动工作。

    Webhook 为自动化工作流程解决了哪些问题?

    Webhook 会将实时事件通知(例如停止完成或路由启动)推送到您的端点,以便系统可以立即做出反应,而无需轮询更新。

    我可以使用 API 构建自定义自动化流程吗?

    是的。您可以使用完整的 REST API 将 Zeo 与内部工具、ERP 或自定义应用程序集成,该 API 支持创建实体和检索详细信息。

    如何利用网络钩子获取实时数据来改进运营?

    Webhook 可即时更新路线进度、预计到达时间变更和司机位置,使系统和团队保持同步,无需手动刷新。

    Webhook 可以通知我哪些类型的事件?

    Webhook 用于触发系统中的事件,例如路线开始、路线结束、司机更新以及其他路线进度。

    使用 API 和 Webhook 对扩展业务规模有帮助吗?

    当然。它们使开发人员能够自动处理大量路由数据,并随着业务的增长将 Zeo 深度集成到企业工作流程中。

    泽奥 博客

    浏览我们的博客,获取富有洞察力的文章、专家建议和鼓舞人心的内容,让您随时了解情况。

    2026年06月12日,丙烷配送路线优化软件Zeo Route Planner成为焦点。

    2026 年丙烷输送路线优化软件指南

    阅读时间:6分钟丙烷配送路线优化软件完整指南,助您节省燃料、符合美国交通部 (DOT) 标准、应对紧急情况并优化配送公司调度……

    2026年06月12日 如何降低丙烷配送成本(专题报道:Zeo路线规划器)

    如何在2026年将丙烷运输成本降低30%

    阅读时间:7分钟了解已被验证有效的策略,通过路线优化、智能调度和效率提升来降低丙烷配送成本,从而减少燃料和人工成本……

    2026年06月12日,冷藏货车路线规划挑战专题报道,Zeo路线规划器

    冷藏货车路线规划挑战与解决方案(2026 年)

    阅读时间:8分钟利用既能满足冷链合规要求又能降低成本的技术,解决冷藏车路线规划难题。获取切实可行的解决方案。

    Xlork是一个以开发者为中心的数据导入平台。它支持将 CSV、Excel 和 Google Sheets 导入功能嵌入到任何应用中,并具备 AI 驱动的列映射和模式验证功能。探索免费的开发者工具,例如 JSON 转 CSV 转换器和调色板生成器。无需再从头构建导入流程——只需引入Xlork SDK免费注册,即可在几分钟内发布干净的数据。