51tracking API

API 调用说明

Get API key

为了使用这个API,您需要生成一个51tracking API 密钥。点击 API Keys.

The base URL

https://api.51tracking.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 51tracking API Key header (Tracking-Api-Key), which you can generate and/or find in the API Keys.

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

包裹物流状态定义

Status Description
pending查询中:新增包裹正在查询中,请等待!
notfound查询不到:包裹目前查询不到。
transit运输途中:包裹正从发件国运往目的国。
pickup到达待取:包裹正在派送中或已到达当地收发点。
delivered成功签收:包裹已成功妥投。
undelivered投递失败:快递员尝试过投递但失败,(这种情况下)通常会留有通知并且会再次试投!
exception可能异常:包裹出现异常,发生这种情况可能是包裹已退回寄件人,清关失败,包裹已丢失或损坏等。
expired运输过久:包裹很长一段时间显示在运输途中,一直没有派送结果。
Notfound SubStatus Description
not found001待揽件,承运商未揽收包裹
not found002完全无信息
Transit SubStatus Description
transit001包裹在运输途中
transit002到达分拣中心
transit003到达目的地网点
transit004抵达目的地国家
transit005海关清关完成
Delivered SubStatus Description
delivered001包裹投递成功
delivered002客户自提完成
delivered003包裹交付给客户并由客户签字签收
delivered004投递到快递柜或由物业门卫代收
Exception SubStatus Description
exception004超时未自提。
exception005异常件
exception006海关扣留。
exception007包裹破损。
exception008未揽收被取消。
exception009收件人拒收
exception010包裹已退回
exception011包裹正在退回途中

API 参数返回列表

ParameterDescription
codeMeta.code
typeMeta.type
messageMeta status description
id51tracking 生成的随机数据来识别跟踪
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.typeDescription
200Success请求成功。
201Created请求成功,此单号曾添加过一次。
202Bad Request请求成功,但请求数量超过限制。
401Unauthorized身份验证失败或用户没有所请求的操作的权限。
4001 Unauthorized 无效的 API 密钥。
4002 Unauthorized API 密钥已被删除。
4012Bad Request请求不能理解或缺少必需的参数。
4013Bad RequestTracking_number 快递单号是必传参数。
4014Bad RequestTracking_number 快递单号格式错误。
4015 Bad Request 'Carrier_code' 的值是无效的。
4016Bad Request快递单号已存在。
4017Bad Request快递单号不存在。
4018Bad Request由于过载风险此功能需要自定义激活。与 service@51tracking.org 联系更多的信息。
4019Bad Request您的余额不足,请及时充值
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服务是临时不可用 (例如预定的平台维护)。稍后再试。

API请求频率限制

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

  • POST /trackings/realtime        实时查询接口,每个账户每秒最多3次请求。
  • GET /trackings/get                    接口,每个账户每秒最多1次请求,每次最多2000个单号。