TrackingMore API

API key

为了使用这个API,您将需要生成一个TrackingMore API 密钥 API Keys.申请免费使用 API.

The base URL

http://api.trackingmore.com/v2

Header

In order to verify and authenticate your application (e.g. your site), all of the requests that you make to the API must include your unique TrackingMore API Key header (Trackingmore-Api-Key), which you can generate and/or find in the TrackingMore Panel.

Content-Type: application/json
Trackingmore-Api-Key: YOUR_API_KEY

跟踪状态列表

StringDescription
pending新增包裹正在查询中,请等待!
notfound包裹目前查询不到。
transit包裹正从发件国运往目的国。
pickup包裹正在派送中或已到达当地收发点,你可以继续派送或收件。
delivered包裹已成功妥投。
undelivered快递员尝试过投递但失败,(这种情况下)通常会留有通知并且会再次试投!
exception包裹出现异常,发生这种情况可能是:包裹已退回寄件人,清关失败,包裹已丢失或损坏等。
expired包裹很长一段时间显示在运输途中,一直没有派送结果。

典型的服务器响应

我们将响应以下状态代码。

CodeDescription
200OK - 请求已成功 (一些 API 调用可能会相反返回 201)。
201Created - 请求成功,已创建了资源。
202Created - 请求已成功,但超过了数量限制。
401Unauthorized - 身份验证失败或用户没有所请求的操作的权限。
4001Unauthorized - 无效的 API 密钥。
4002Unauthorized - API 密钥已被删除。
4012Bad Request - 请求不能理解或缺少必需的参数。
4013Bad Request - Tracking_number 是必需的。
4014Bad Request - 'Tracking_number' 的值是无效的。
4015Bad Request - 'Carrier_code' 的值是无效的。
4016Bad Request - 跟踪已存在。
4017Bad Request - 跟踪并不存在。
4018Bad Request - 由于过载风险此功能需要自定义激活。与 [email protected] 联系更多的信息。
4020Bad Request - 数量限制一次 200。
4021Bad Request - 你的余额不够,所以你不能调用API请求数据。
4031No Content - 请求已成功,但响应为空。
4032No Content - 无法检测到快递。
402Payment Required - 付款要求。
403Forbidden - 访问被拒绝。
404Not Found - 找不到资源。
405Method Not Allowed - 指定的资源不支持请求的方法。
409Conflict - 由于冲突,无法完成请求。
429Too Many Requests - 超过 API 限制。请求暂停,等待两分钟,然后再试。
500Server error
503Service Unavailable - 服务是临时不可用 (例如预定的平台维护)。稍后再试。

请求速率限制

我们对请求次数做了限制。注意:超出此限制将收到“429错误”提示.

  • 实时查询,每个IP每秒最多3次请求

  • 列出所有的跟踪,每个IP一秒一次请求,每次最多2000条跟踪项目。