API key

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

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 - 由于过载风险此功能需要自定义激活。与 service@trackingmore.org 联系更多的信息。
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一秒一次请求,每次最多200条跟踪项目。

Multilingual call

目前支持的api调用官方多语言版本运输商列表.

运输商简码 运输商名称
china-ems China EMS
belgium-post Belgium post
colissimo French Post - Colissimo
chronopost France EMS - Chronopost
israel-post Israel post
belpochta Belarus post
emirates-post Emirates Post
latvijas-pasts Latvia post
moldova-post Moldova post
kazpost Kazakhstan post
bosnia-and-herzegovina-post Bosnia and Herzegovina post
luxembourg-post Luxembourg post
omniva Estonia post
iceland-post Iceland post
azerbaijan-post Azerbaijan post
correos-bolivia Bolivia post
turkey-post Turkey post
correo-argentino Argentina post
austria-post Austrian Post
denmark-post Denmark post
macao-post Macao Post
georgian-post Georgia post
tunisia-post Tunisia post
kyrgyzpost Kyrgyzstan post
japan-post Japan post
canada-post Canada post
korea-post Korea Post
saudi-post Saudi Post
malaysia-post Malaysia post
lietuvos-pastas Lithuania post
dhl-germany Deutsche Post DHL
hong-kong-post Hong Kong Post
israel-post Israel post
vietnam-post Vietnam post
sweden-posten Sweden Posten
poczta-polska Poland post
finland-posti Finland post - Posti
czech-post Česká Pošta
posten-norge Posten Norge
ctt Portugal post - CTT
swiss-post Swiss Post
slovakia-post Slovakia post
greece-post ELTA Hellenic Post
correos-spain correos
armenia-post Armenia post
serbia-post Serbia post
brazil-correios Brazil Correios
dhl DHL
tnt TNT
fedex Fedex
ups UPS
bartolini BRT Bartolini
gls GLS
dpd DPD
sfb2c S.F International
dhlparcel-nl DHL Parcel Netherlands
dhl-poland DHL Poland Domestic
dhl-es DHL Spain Domestic
gls-italy GLS Italy
asendia-de Asendia Germany
kerry-logistics Kerry Express
wishpost WishPost
aramex Aramex
dhl-active DHL Active Tracing
sfcservice SFC Service
sf-express S.F Express