首页 > 代码库 > 使用免费快递接口查询物流信息
使用免费快递接口查询物流信息
电商，ERP厂商可能需要物流信息接口，对运单号的物流轨迹进行跟踪，通常有些免费的不好用，及时性要求达不到，收费的也太贵了。最近发现一个免费的API接口，及时性非常高，基本上就是实时返回。需要可以联系QQ群 479197998
订阅请求
发起方:本服务用户，即贵公司
地址:http://182.61.40.226:8080/kd-server/poll
通信协议:HTTP
请求类型:POST
字符集:utf-8
请求内容:
param=body
Body格式(json)：
{
"kd_code": "123456", //订阅的快递单号，单号的最大长度是32个字符
"kd_company": "yuantong", //订阅的快递公司的编码，一律用小写字母，见章五《快递公司编码》
"app_key": "*********" //授权码，由管理员分配
}
订阅返回
由快递100直接通过订阅请求的response返回。
返回格式（json）：
{
"result":"true",
"returnCode":"200",
"message":"提交成功"
}
result: "true"表示成功，false表示失败
returnCode:
200: 提交成功
701: 拒绝订阅的快递公司
700: 订阅方的订阅数据存在错误（如不支持的快递公司、单号为空、单号超长等）
600: 您不是合法的订阅者（即授权Key出错）
500: 服务器错误（即快递100的服务器出理间隙或临时性异常，有时如果因为不按规范提交请求，比如快递公司参数写错等，也会报此错误）
501:重复订阅
推送请求
发起方: 快递100
请求地址: 由管理配入系统
通信协议: HTTP
请求类型: POST
字符集: utf-8
请求内容: param=body
body格式(JSON)：
{
"status": "got",
"billstatus": "polling", /*监控状态:polling:监控中，abort:中止 */
"lastResult": {
"message": "ok", /*ok 成功获取数据 */
"push_time": "2017/3/13 19:14:52", /*推送时间 */
"state": "3", /*快递单当前签收状态，包括0在途中3已签收 */
"status": "200",
"kd_company": "xxxx", /*快递公司 */
"kd_code": "xxxx", /*快递单号 */
"data": [
{
"time": "2017-02-14 15:06:21", /*时间 */
"ftime": "2017-02-14 15:06:21", /*时间*/
"context": "快件已签收,签收人是朋友" /*内容 */
},
{
"time": "2017-02-14 15:06:21",
"ftime": "2017-02-14 15:06:21",
"context": "快件已签收,签收人是朋友"
},
{
"time": "2017-02-14 09:31:42",
"ftime": "2017-02-14 09:31:42",
"context": "武昌光谷二部(15337180407)的王战胜15717179427正在派件"
},
{
"time": "2017-02-14 08:15:43",
"ftime": "2017-02-14 08:15:43",
"context": "快件到达武昌光谷二部(15337180407)，上一站是武汉(027-84639979)扫描员是02730"
},
{
"time": "2017-02-13 23:58:23",
"ftime": "2017-02-13 23:58:23",
"context": "快件由武汉(027-84639979)发往武昌光谷二部(15337180407)"
},
{
"time": "2017-02-13 11:17:54",
"ftime": "2017-02-13 11:17:54",
"context": "快件由武汉分拨中心发往武汉(027-84639979)"
},
{
"time": "2017-02-13 01:48:02",
"ftime": "2017-02-13 01:48:02",
"context": "快件由郑州分拨中心发往武汉分拨中心"
},
{
"time": "2017-02-13 01:46:45",
"ftime": "2017-02-13 01:46:45",
"context": "快件到达郑州分拨中心，上一站是无扫描员是刘会丹"
},
{
"time": "2017-02-12 20:52:22",
"ftime": "2017-02-12 20:52:22",
"context": "快件由洛阳(037963602588、2566,2599、2511)发往郑州分拨中心"
},
{
"time": "2017-02-12 19:31:40",
"ftime": "2017-02-12 19:31:40",
"context": "快件由洛阳(037963602588、2566,2599、2511)发往郑州分拨中心"
},
{
"time": "2017-02-12 19:31:39",
"ftime": "2017-02-12 19:31:39",
"context": "洛阳(037963602588、2566,2599、2511)已进行装袋扫描"
},
{
"time": "2017-02-12 17:51:40",
"ftime": "2017-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":""}
使用免费快递接口查询物流信息