TrackingMore API

Get API key

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

The base URL

https://api.trackingmore.com/v2

Note : "http" is also supported.

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 API Keys.

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

快递状态列表

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

API 参数返回列表

ParameterDescription
codeMeta.code
typeMeta.type
messageMeta status description
idTrackingmore 生成的随机数据来识别跟踪
tracking_number运单号
carrier_code快递简码
status包裹状态
created_at运单号添加时间
updated_at运单号最后一次自动查询时间
order_create_time订单创建时间
title商品标题
order_id订单号
comment商品备注
customer_name客户名称
customer_email客户邮箱
original_country发件国
singed_by签收人
lastEvent最新一条物流信息
lastUpdateTime最新一条物流信息扫描时间
destination_country目的国
itemTimeLength包裹运输时间
stayTimeLength包裹停留时间(自从第一条信息出现后无物流信息的时间)
origin_info发件国信息
ItemReceived包裹上网时间
ItemDispatched包裹封发时间
DepartfromAirport到达机场时间
ArrivalfromAbroad到达目的地国的时间
CustomsClearance包裹移交给海关的时间
DestinationArrived到达待取时间
weblink运输商官网链接
phone运输商电话号码
trackinfo详细物流信息
Date每一条物流信息扫描时间
StatusDescription每一条物流信息内容
Details每一条物流信息扫描地点
destination_info目的国物流信息

典型的服务器响应

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

Meta.codeMeta.typeMessage
200Success请求已成功 (一些 API 调用可能会相反返回 201)。
201Created请求成功,已创建了资源。
202Bad Request请求已成功,但超过了数量限制。
401Unauthorized身份验证失败或用户没有所请求的操作的权限。
4001 Unauthorized 无效的 API 密钥。请确保自己的申请API key的账户与调用API的服务器同时在国内或国外。即如果你的服务器在国外,你需要翻墙登录trackingmore网站进而获取API key。 检查 API调用说明
4002 Unauthorized API 密钥已被删除。请确保自己的申请API key的账户与调用API的服务器同时在国内或国外。即如果你的服务器在国外,你需要翻墙登录trackingmore网站进而获取API key。 检查 API调用说明
4012Bad Request请求不能理解或缺少必需的参数。
4013Bad RequestTracking_number 是必需的。
4014Bad Request'Tracking_number' 的值是无效的。
4015 Bad Request 'Carrier_code' 的值是无效的。 检查 运输商简码
4016Bad Request跟踪已存在。
4017Bad Request跟踪并不存在。
4018Bad Request由于过载风险此功能需要自定义激活。与 [email protected] 联系更多的信息。
4020Bad Request数量限制一次 200。
4021 Bad Request 你的余额不够,所以你不能调用API请求数据。 点击 这里购买
4031 No Content 请求已成功,但响应为空。 请尝试 POST /trackings/post 然后 GET /trackings/get
4032 No Content 无法识别运输商。 放弃自动识别,给运单号指定相应运输商。 查询运输商简码。
4033No Content"包裹状态" 值是无效的。
402Payment Required付款要求。
403Forbidden访问被拒绝。
404Not Found找不到资源。
405Method Not Allowed指定的资源不支持请求的方法。
409Conflict由于冲突,无法完成请求。
429Too Many Requests超过 API 限制。请求暂停,等待两分钟,然后再试。
500Server error
503Service Unavailable服务是临时不可用 (例如预定的平台维护)。稍后再试。

请求速率限制

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

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

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

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