物流常用API接入流程總結-快遞鳥

本文轉載自查看原文 2020-02-17 09:23 988 物流API

1、注冊快遞鳥賬號

網址：http://www.kdniao.com/reg

2、登錄快遞鳥用戶后台

網址：http://www.kdniao.com/login

注：登錄快遞鳥用戶后台默認加載頁或者點擊菜單（我的會員中心）可以看到用戶ID和API Key，分別對應各接口文檔中的EBusinessID、AppKey。（EBusinessID=用戶ID，AppKey =API Key），

測試的過程中，我們用快遞鳥提供的測試用戶ID和API Key

測試商戶ID：test1617571

測試API key：554343b2-7252-439b-b4eb-1af42c8f2175(此Key僅限測試環境使用)

3、實名認證

注：

3.1、認證類型、應用類型如實選擇即可，類型的選擇不會影響接口的使用，接口返回的數據也與選擇結果無關；

3.2，必須實名認證，這一步很重要，沒有認證是無法使用接口的。

3.3、標記為*的為必填，要求上傳清晰、jpg格式且小於2M的證件圖片；

3.4、技術對接人信息填寫我們公司的技術人員，暫時沒有，可先填自己的信息；

3.5、如還有其他疑問可加入商務合作群（群號：616310430）進行咨詢。

4、開通會員服務

4.1、物流查詢（免費版）會員套餐為免費版，有效期1年結束后，如在近3個月內有數據交互系統會自動免費續期；

5、開發對接

5.1、切記，請求接口之前一定要實名認證並開通相關會員服務，否則會請求失敗並返回提示“未申請開通接口”；

5.2、可下載“快遞鳥接口技術文檔”進行參考；

下載地址：http://www.kdniao.com/documents

5.3、可下載“即時查詢demo”進行參考（僅提供了.NET、Java、PHP三種語言demo）；

下載地址：http://kdniao.com/documents-demo

5.4、查看快遞公司對應快遞鳥的編碼可以下載“快遞鳥接口支持快遞公司編碼列表.xlsx”。

下載地址：http://www.kdniao.com/documents

5.5、接入過程中如有疑問請先參考快遞鳥官網常見問題進行解決（http://www.kdniao.com/help），也可以進入快遞鳥官網加入技術對接群（群號：620453345）進行咨詢。

5.6、接口請求對應指令

即時查詢（RequestType：1002/8001）

物流跟蹤（RequestType：1008/8008）

電子面單（RequestType：1007）

預約取件（RequestType：1001）

單號識別（RequestType：2002）

上門取件（RequestType：1801）

代收貨款（RequestType：9001）

隱私快遞（RequestType：3001）

智選物流（RequestType：2006）

物流短信（RequestType：8102）

物流評價（RequestType：1011）

實名寄件（RequestType：1021）

5.7、其它開發總結

5.7.1 訂閱推送，推送時會推送requestType、requestData和DataSign三個參數，我們開發一個接收地址，接收這三個參數，成功接收后需要在5S內做出響應，按快遞鳥提供的報文格式返回成功接收的報文，否則會超時。快遞鳥會再次推送此數據，建議大家接收到快遞鳥的推送數據后，儲存並馬上返回響應。或許在根據自己業務需求處理報文，如果我們先進行處理，再做出響應，耗時會比較久，會造成網絡超時，傳輸效率低下。會造成快遞鳥重復推送信息的情況發生。快遞鳥普通用戶一般推送時效為2-12小時。

推送規則，在沒有返回信息或者返回不符合規定的情況下，快遞鳥會判斷推送失敗。推送失敗后會重試推送2次，首次間隔15分鍾，二次間隔30分鍾，兩次都失敗就不會再推送，直到下次有軌跡更新才會再次推送。建議我們嚴格按照技術文檔進行返回

5.7.2、沙箱調試平台配置回調地址，測試推送接口，回調地址是我們提供給快鳥，

沙箱調試平台地址：http://kdniao.com/UserCenter/v2/SandBox/PushQueryParam.aspx

我們提供的回調地址一定是外網可以訪問的地址。不支持內容地址。

測試、配置步驟如下：