移动应用程序
构建自定义集成
使用 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 端点
通过您喜爱的语言的示例快速入门
创建并优化包含多个停靠点的路线 卷曲 -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": "已放在门口"}'
自动更新适用于任何有定期巡检的行业。
电商平台每小时通过 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 深度集成到企业工作流程中。
浏览我们的博客,获取富有洞察力的文章、专家建议和鼓舞人心的内容,让您随时了解情况。