
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
我們提供的回調位址一定是外網可以通路的位址。不支援内容位址。
測試、配置步驟如下:
5.8、快遞鳥并發要求
即時查詢接口:并發不超過10次/秒
物流跟蹤訂閱接口:并發不超過30次/秒
電子面單接口:并發不超過20次/秒
5.9、傳回‘無可用套餐’情況
1、即時查詢接口限量,免費版每日查詢量有500次的限制,超過500次後,請求傳回“無可用套餐”,次日可以正常請求。
登入使用者背景檢視當天使用量:
(http://www.kdniao.com/UserCenter/v2/Public/ProductDashboard.aspx?guid=6d25d765-c978-40d5-a63c-0f5e7835336b)。
2、訂購會員服務到期,到期後請求傳回“無可用套餐”,需要重新訂購。