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

3,396 阅读5分钟

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

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

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

地址:www.kdniao.com

通信协议: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=body

 

body格式(JSON):

{

"status": "got",            

"billstatus": "polling",   /*监控状态:polling:监控中,abort:中止 */



"lastResult": {

    "message": "ok",       /*ok 成功获取数据 */

    "push_time": "2019/3/13 19:14:52", /*推送时间 */



    "state": "3",         /*快递单当前签收状态,包括0在途中3已签收 */



    "status": "200",

    "kd_company": "xxxx",  /*快递公司 */

    "kd_code": "xxxx", /*快递单号 */

    "data": [

        {

            "time": "2019-02-14 15:06:21",    /*时间 */

            "ftime": "2019-02-14 15:06:21",   /*时间*/

            "context": "快件已签收,签收人是朋友" /*内容 */

        },

        {

            "time": "2019-02-14 15:06:21",

            "ftime": "2019-02-14 15:06:21",

            "context": "快件已签收,签收人是朋友"

        },

        {

            "time": "2019-02-14 09:31:42",

            "ftime": "2019-02-14 09:31:42",

            "context": "武昌光谷二部(15337180407)的王战胜15717179427正在派件"

        },

        {

            "time": "2019-02-14 08:15:43",

            "ftime": "2019-02-14 08:15:43",

            "context": "快件到达武昌光谷二部(15337180407),上一站是武汉(027-84639979)扫描员是02730"

        },

        {

            "time": "2019-02-13 23:58:23",

            "ftime": "2019-02-13 23:58:23",

            "context": "快件由武汉(027-84639979)发往武昌光谷二部(15337180407)"

        },

        {

            "time": "2019-02-13 11:17:54",

            "ftime": "2019-02-13 11:17:54",

            "context": "快件由武汉分拨中心发往武汉(027-84639979)"

        },

        {

            "time": "2019-02-13 01:48:02",

            "ftime": "2019-02-13 01:48:02",

            "context": "快件由郑州分拨中心发往武汉分拨中心"

        },

        {

            "time": "2019-02-13 01:46:45",

            "ftime": "2019-02-13 01:46:45",

            "context": "快件到达郑州分拨中心,上一站是无扫描员是刘会丹"

        },

        {

            "time": "2019-02-12 20:52:22",

            "ftime": "2019-02-12 20:52:22",

            "context": "快件由洛阳(037963602588、2566,2599、2511)发往郑州分拨中心"

        },

        {

            "time": "2019-02-12 19:31:40",

            "ftime": "2019-02-12 19:31:40",

            "context": "快件由洛阳(037963602588、2566,2599、2511)发往郑州分拨中心"

        },

        {

            "time": "2019-02-12 19:31:39",

            "ftime": "2019-02-12 19:31:39",

            "context": "洛阳(037963602588、2566,2599、2511)已进行装袋扫描"

        },

        {

            "time": "2019-02-12 17:51:40",

            "ftime": "2019-02-12 17:51:40",

            "context": "洛阳(037963602588、2566,2599、2511)的骆康鞋业已收件,扫描员是司机5"

        }

    ]

}