系统接入 / API v1 预览

从你的 TMS
发起路线计算。

示例展示如何用客户系统的订单与车辆编号提交任务,按回执查询进度,领取通过独立校验的车辆路线与站序。

从场景结构开始 →

调用示例

一个批次,四个接口

提交完整场景

POST /api/v1/jobs
Authorization: Bearer <工作空间密钥>
Idempotency-Key: <业务请求编号>
Content-Type: application/json

收到 202 后保存 id、status_url 和 result_url。请求体的 scenario 字段包含完整配置。

查看请求与处理方法 ↗

下载已校验结果

GET /api/v1/jobs/{id}/result

在有效期内保存完整响应,按任务编号核对校验、路线与指标。

查看请求与处理方法 ↗

接入指南

场景结构

先下载部署环境公布的 JSON Schema,核对订单、车辆、规则和经纬度,再把接收方要校验的那一版配置保存在测试环境。

提交任务

把完整场景包放进 scenario,用同一个业务请求编号贯穿提交和断线重试。

查询状态

使用提交回执中的 status_url 读取状态。运行中的任务会给出下一次查询应等待的时间。

领取结果

任务完成后读取 result_url,将校验结果与车辆路线一起归档,再交给调度员复核。

失败与重试

接入程序根据 HTTP 状态码和任务状态决定下一步,让重复提交仍然指向同一次计算。

密钥与隔离

业务账号与管理员在各自有权管理的工作空间签发具名密钥,TMS 后端用密钥访问该空间的计算任务。

回到业务现场

比较两版配送计划 ↗用运行记录核对建议 ↗