全国快递物流查询-快递单号查询接口api

电商，ERP厂商可能需要物流信息接口，对运单号的物流轨迹进行跟踪，通常有些免费的不好用，及时性要求达不到，收费的也太贵了。最近发现一个免费的API接口，及时性非常高，基本上就是实时返回。

快递查询接口（物流跟踪接口）/api-all 是快递鸟为用户提供的定制化服务，用户可将订单信息通过快递鸟订阅给快递公司，快递公司更新轨迹后，快递鸟将实时转换成快递鸟标准接口形式，推送给用户，起到实时推送的作用，提高效率。物流跟踪接口不限调用单量，适用于量大的电商、ERP系统商、仓储和快递柜公司，量小的可以对接即时查询接口。

订阅请求

发起方:本服务用户，即贵公司

地址:

通信协议:HTTP

请求类型:POST

字符集:utf-8

请求内容:

param=body

Body格式(json)：

{

"kd_code": "123456", //订阅的快递单号，单号的最大长度是32个字符"kd_company": "yuantong", //订阅的快递公司的编码，一律用小写字母，见章五《快递公司编码》"app_key": "*********"//授权码，由管理员分配

}

订阅返回

由快递鸟直接通过订阅请求的response返回。

返回格式（json）：

{"result":"true","returnCode":"200","message":"提交成功"}result: "true"表示成功，false表示失败returnCode:200: 提交成功701: 拒绝订阅的快递公司700: 订阅方的订阅数据存在错误（如不支持的快递公司、单号为空、单号超长等）600: 您不是合法的订阅者（即授权Key出错）500: 服务器错误（即快递鸟的服务器出理间隙或临时性异常，有时如果因为不按规范提交请求，比如快递公司参数写错等，也会报此错误）501:重复订阅推送请求发起方: 快递鸟请求地址: 由管理配入系统通信协议: HTTP请求类型: POST字符集: utf-8请求内容: param=bodybody格式(JSON)：{"status": "got", "billstatus": "polling", /*监控状态:polling:监控中，abort:中止 */"lastResult": {"message": "ok", /*ok 成功获取数据 */"push_time": "/3/13 19:14:52", /*推送时间 */"state": "3", /*快递单当前签收状态，包括0在途中3已签收 */"status": "200","kd_company": "xxxx", /*快递公司 */"kd_code": "xxxx", /*快递单号 */"data": [{"time": "-02-14 15:06:21", /*时间 */"ftime": "-02-14 15:06:21", /*时间*/"context": "快件已签收,签收人是朋友" /*内容 */},{"time": "-02-14 15:06:21","ftime": "-02-14 15:06:21","context": "快件已签收,签收人是朋友"},{"time": "-02-14 09:31:42","ftime": "-02-14 09:31:42","context": "武昌光谷二部(15337180407)的王战胜15717179427正在派件"},{"time": "-02-14 08:15:43","ftime": "-02-14 08:15:43","context": "快件到达武昌光谷二部(15337180407)，上一站是武汉(027-84639979)扫描员是02730"},{"time": "-02-13 23:58:23","ftime": "-02-13 23:58:23","context": "快件由武汉(027-84639979)发往武昌光谷二部(15337180407)"},{"time": "-02-13 11:17:54","ftime": "-02-13 11:17:54","context": "快件由武汉分拨中心发往武汉(027-84639979)"},{"time": "-02-13 01:48:02","ftime": "-02-13 01:48:02","context": "快件由郑州分拨中心发往武汉分拨中心"},{"time": "-02-13 01:46:45","ftime": "-02-13 01:46:45","context": "快件到达郑州分拨中心，上一站是无扫描员是刘会丹"},{"time": "-02-12 20:52:22","ftime": "-02-12 20:52:22","context": "快件由洛阳(037963602588、2566,2599、2511)发往郑州分拨中心"},{"time": "-02-12 19:31:40","ftime": "-02-12 19:31:40","context": "快件由洛阳(037963602588、2566,2599、2511)发往郑州分拨中心"},{"time": "-02-12 19:31:39","ftime": "-02-12 19:31:39","context": "洛阳(037963602588、2566,2599、2511)已进行装袋扫描"},{"time": "-02-12 17:51:40","ftime": "-02-12 17:51:40","context": "洛阳(037963602588、2566,2599、2511)的骆康鞋业已收件，扫描员是司机5"}]}

}

Status：status=abort，即监控结束，表示message为“40天查询无记录”或“40天无变化时”， 此单的生命周期已结束

当status=abort且单号三天无结果时，返回的信息如下：

{“message”:“3天查询无记录”,“status”:“abort”,“lastResult”:{“message”:“快递公司参数异常：单号不存在或者已经过期”,“state”:“0”,“data”:[],“status”:“201”,“com”:“XXXXX”,“nu”:“XXXXXXXX”,“ischeck”:“0”,“condition”:""},“billstatus”:""}