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运输过久 - 包裹很长一段时间显示在运输途中,一直没有派送结果。

API 参数返回列表

StringDescription
code响应状态代码
type响应信息类型
message状态描述
tracking_number快递单号
carrier_code快递商简码
status物流状态
original_country发件国家
destination_country目的国家
itemTimeLength包裹的运输时间
origin_info发件国家物流信息
destination_info目的国家物流信息
weblink物流商官网地址
phone物流商电话
Date物流信息的时间
StatusDescription物流信息详情
Details地址信息
lastEvent最新一条物流信息
lastUpdateTime最新一条物流信息的更新时间
ItemReceived上网时间,包裹出现上网信息的时间
ItemDispatched封发时间,包裹封发的时间
DepartfromAirport交航时间,包裹到达机场的时间
ArrivalfromAbroad落地时间,包裹到达目的国家的时间
CustomsClearance清关时间,包裹在海关处清关的时间
DestinationArrived达到目的地时间,包裹到达当地派送点的时间
Order_create_time下单时间

典型的服务器响应

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

CodeDescription
200OK - 请求已成功 (一些 API 调用可能会相反返回 201)。
201Created - 请求成功,已创建了资源。
202Created - 请求已成功,但超过了数量限制。
401Unauthorized - 身份验证失败或用户没有所请求的操作的权限。
4001Unauthorized - 无效的 API 密钥。请确保自己的申请API key的账户与调用API的服务器同时在国内或国外。即如果你的服务器在国外,你需要翻墙登录trackingmore网站进而获取API key。
4002Unauthorized - API 密钥已被删除。请确保自己的申请API key的账户与调用API的服务器同时在国内或国外。即如果你的服务器在国外,你需要翻墙登录trackingmore网站进而获取API key。
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 - 无法检测到快递。
4033No Content - The value of `status` is invalid.
402Payment Required - 付款要求。
403Forbidden - 访问被拒绝。
404Not Found - 找不到资源。
405Method Not Allowed - 指定的资源不支持请求的方法。
409Conflict - 由于冲突,无法完成请求。
429Too Many Requests - 超过 API 限制。请求暂停,等待两分钟,然后再试。
500Server error
503Service Unavailable - 服务是临时不可用 (例如预定的平台维护)。稍后再试。

请求速率限制

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

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

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

  • Facebook Twitter Android App Store
  • ©2014-2017 TrackingMore.All Rights Reserved.