TrackingMore API

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包裹很长一段时间显示在运输途中,一直没有派送结果。
Notfound SubStatus Description
not found001待揽件,只有一条订单生成的信息。
not found002完全无信息。
Exception SubStatus Description
exception001发货无信息。
exception002超时无更新。
exception003超时未签收。
exception004超时未自提。
exception005退回件。
exception006海关扣留。
exception007包裹破损。
exception008未揽收被取消。
  • Tips

    其中,exception001、exception002、exception003 对应的是后台你们是否有设置的这三个项目的异常。(用户自定义:运输商异常提醒设置

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请求成功。
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 RequestTracking_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接口创建单号,然后再调用Get接口获取物流信息。 请尝试 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错误”提示.

  • POST /trackings/realtime        实时查询接口,每个账户每秒最多3次请求。
  • GET /trackings/get                    接口,每个账户每秒最多1次请求,每次最多2000个单号。
  • Facebook Twitter Android App Store
  • ©2014-2018 TrackingMore.All Rights Reserved.