错误

Tracksuite 使用标准的 HTTP 响应代码来表示 API 请求的成功或失败。通常情况下：

• 2xx 范围内的代码表示成功。创建、查询摘要和批量查询还要看 errors，每一单是单独接受或拒绝的。
• 4xx 范围内的代码表示根据所提供的信息未能成功执行。例如，缺少必填参数、API key 无效，或额度不足。
• 这些响应都包含 message。200 里失败的单还会带 code，简要说明这一单的错误。
• 5xx 范围内的代码表示 Tracksuite 服务器出错，这种情况很少见。

字段

messagestring

可读的原因。HTTP 错误里会有。

codestring | null

查询摘要和批量查询的失败条目才有。创建失败和 HTTP 错误没有这个字段。

referIdstring | null

失败条目的业务标识。请求按 referId 查的时候才有。

trackingNumberstring | null

失败条目的运单号。请求按运单号查的时候才有。

HTTP 状态

200	OK	请求执行了。创建、查询摘要、批量查询里失败的单在 errors。
400	Bad Request	校验失败、referId 重复、缺少标识，或额度不足。
401	Unauthorized	API key 未传、无效或已过期。
403	Forbidden	用户已禁用。
404	Not Found	找不到这条跟踪或它的轨迹。
423	Locked	这些 referId 正在入队。
500	Server Error	请求未能完成。

错误码

• NOT_FOUND

  这个 referId 或运单号还没有跟踪。

• DETAIL_NOT_FOUND

  路由存在，但轨迹还不可用。

• PROCESSING

  异步创建还没有绑定路由。

• CREATE_FAILED

  异步创建未能绑定路由。

• UPDATE_FAILED

  这条跟踪未能更新。