摘要：快遞查詢接口是使用的物流單號即可實現(xiàn)查詢物流信息。目前快遞查詢接口有兩種實現(xiàn)方式，一種是主動查詢，一種是訂閱接口推送數(shù)據(jù)。另外，快遞鳥還有在途監(jiān)控電子面單等其他的接口方案，可以根據(jù)公司需求來選擇。

快遞查詢API接口是使用的物流單號即可實現(xiàn)查詢物流信息。主要應(yīng)用在電商商城、ERP系統(tǒng)商、WMS系統(tǒng)商、快遞柜、銀行等企業(yè)。多家快遞物流公司接口統(tǒng)一接入，建議對接接口提供商，一次性可以接入多家快遞，在后期的技術(shù)維護也會省下很多工作。

目前快遞查詢API接口有兩種實現(xiàn)方式，一種是主動查詢，一種是訂閱接口推送數(shù)據(jù)。以快遞鳥接口為例（接口對接需要接口秘鑰，這里用的是測試的，不能夠正式使用，可以到快遞鳥官網(wǎng)申請http://www.kdniao.com/，是免費申請秘鑰的）最后附有兩個方法的demo

一.主動查詢（即時查詢API）

1）接口規(guī)則
a、查詢接口支持按照運單號查詢(單個查詢，并發(fā)不超過10個/S)。

b、指定的物流運單號選擇相應(yīng)的快遞公司編碼，格式不對或則編碼錯誤都會返失敗的信息。如EMS物流單號應(yīng)選擇快遞公司編碼（EMS）

c、返回的物流跟蹤信息按照發(fā)生的時間升序排列。

d、接口指令1002。

e、請求地址：登陸獲取

2）系統(tǒng)級和應(yīng)用級輸入?yún)?shù)

3）返回結(jié)果參數(shù)

4）JSON請求示例

{

"OrderCode": "",

"ShipperCode": "SF",

"LogisticCode": "118650888018"
}

// "SF"為順豐快遞公司編碼，其他編碼可在快遞鳥官網(wǎng)下載

5）JSON返回示例
//沒有物流軌跡的

{

"EBusinessID": "1109259",

"Traces":[],
"OrderCode": "",

"ShipperCode": "SF",

"LogisticCode": "118461988807",

"Success": true,

"Reason": null

}

//有物流軌跡的

{

"EBusinessID": "1109259",

"OrderCode":"",
"ShipperCode": "SF",

"LogisticCode": "118461988807",

"Success": true,

"CallBack":"",
"State": 3,

"Reason": null,

"Traces":[

    {

       "AcceptTime": "2014/06/25 08:05:37",

       "AcceptStation": "正在派件..(派件人:鄧裕富,電話:18718866310)[深圳 市]",

       "Remark": null

    },

    {

       "AcceptTime": "2014/06/25 04:01:28",

       "AcceptStation": "快件在 深圳集散中心 ,準備送往下一站 深圳 [深圳市]",

       "Remark": null

    },

    {

        "AcceptTime": "2014/06/2501:41:06",

       "AcceptStation": "快件在 深圳集散中心 [深圳市]",

       "Remark": null

    },

    {

       "AcceptTime": "2014/06/24 20:18:58",

       "AcceptStation": "已收件[深圳市]",

       "Remark": null

    },

    {

       "AcceptTime": "2014/06/24 20:55:28",

       "AcceptStation": "快件在 深圳 ,準備送往下一站 深圳集散中心 [深圳市]",

       "Remark": null

    },

    {

       "AcceptTime": "2014/06/25 10:23:03",

       "AcceptStation": "派件已簽收[深圳市]",

       "Remark": null

    },

    {

       "AcceptTime": "2014/06/25 10:23:03",

       "AcceptStation": "簽收人是：已簽收[深圳市]",

       "Remark": null

    }

]
}

二.訂閱接口推送數(shù)據(jù)（物流跟蹤API）

訂閱查詢接口是定制化服務(wù)，用戶可將訂單信息訂閱給快遞公司，快遞公司更新軌跡后，將實時轉(zhuǎn)換成標(biāo)準接口形式，推送給用戶，起到實時推送的作用，提高效率。
同時用戶訂閱的數(shù)據(jù)還能選擇是否通知快遞員上門，實現(xiàn)在線下單功能。另外，快遞鳥還有在途監(jiān)控、電子面單等其他的接口方案，可以根據(jù)公司需求來選擇。

1）接口規(guī)則
a、訂單接收的信息(分給了的網(wǎng)點，業(yè)務(wù)員的信息)，會通過推送接口推給客戶（訂閱并發(fā)不超過30次/S）客戶需要按要求實現(xiàn)接口。

b、僅支持Json格式。

c、請求指令1008。

d、測試接口地址：http://testapi.kdniao.cc:8081/api/dist

e、聯(lián)調(diào)通過后請更換為正式地址：http://api.kdniao.cc/api/dist

f、分發(fā)及訂閱接口需要客戶方實現(xiàn)回調(diào)接口，回調(diào)RequestType(1008)

2）系統(tǒng)級和應(yīng)用級參數(shù)
系統(tǒng)級輸入?yún)?shù)

3）JSON請求示例

{

"ShipperCode":"SF",
"OrderCode":"SF201608081055208281",

"LogisticCode":"3100707578976",

"PayType":"1",

"ExpType":"1",

"CustomerName":"",

"CustomerPwd":"",

"MonthCode":"",

"IsNotice":"0",

"Sender":{

    "Name":"1255760",

    "Tel":"",

   "Mobile":"13700000000",

    "ProvinceName":"廣東省",

    "CityName":"深圳市",

    "ExpAreaName":"福田區(qū)",

    "Address":"測試地址"

},

"Receiver":{

    "Name":"1255760",

    "Tel":"",

   "Mobile":"13800000000",

    "ProvinceName":"廣東省",

    "CityName":"深圳市",

    "ExpAreaName":"龍華新區(qū)",

    "Address":"測試地址2"

},

"Commodity":[

    {

        "GoodsName":"書本"

    }

]
}

5）JSON返回示例
{

"EBusinessID":"1151847",

"UpdateTime": "2016-08-0916:42:38",

"Success": true,

"Reason": ""

"EstimatedDeliveryTime":"2016-8-12"
}
即時查詢APIdemo


物流跟蹤APIdemo
![clipboard.png](/img/bVbvq4l)
![clipboard.png](/img/bVbvq4N)
![clipboard.png](/img/bVbvq4Y)
![clipboard.png](/img/bVbvq41)
![clipboard.png](/img/bVbvq5g)
![clipboard.png](/img/bVbvq5N)
![clipboard.png](/img/bVbvq2U)