快遞單號查詢自動識別API提供快遞單號自動識別快遞物流公司,支持順豐、中通、圓通、圓通、韻達、百世、郵政、EMS快遞單號自動識別,只需快遞單號,即可查詢418家國內外快遞物流軌跡。
單號識別API爲用戶提供單號識別快遞公司服務,依託於快遞鳥大數據平臺,用戶提供快遞單號,即可實時返回可能的一個或多個快遞公司,存在多個快遞公司結果的,大數據平臺根據可能性、單號量,進行智能排序。
API參數
一、接口描述/說明
(1)該接口僅對運單號做出識別,識別可能屬於的一家或多家快遞公司。
(2)接口並不返回物流軌跡,用戶可結合即時查詢接口和訂閱查詢接口完成軌跡查詢、訂閱的動作。
(3)接口識別會返回一家或者多家快遞公司,返回的數據根據快遞鳥大數據分析結果排序,排名靠前的命中率更高。
(4)若識別失敗,快遞鳥返回的匹配結果爲空。
(5)接口支持的消息接收方式爲HTTP POST,請求方法的編碼格式(utf-8):“application/x-www-form-urlencoded;charset=utf-8”。
(6)接口地址: API測試地址:http://sandboxapi.kdniao.com:8080/kdniaosandbox/gateway/exterfaceInvoke.json
API正式地址:http://api.kdniao.com/Ebusiness/EbusinessOrderHandle.aspx
備註:R-必填(Required),O-可選(Optional),C-報文中該參數在一定條件下可選(Conditional)
二、接口參數
請求內容字段定義:
參數名稱類型說明是否必須LogisticCodeString物流單號R
返回參數定義:
參數名稱類型說明必須要求EBusinessIDString電商用戶IDRLogisticCodeString物流單號RSuccessBool成功與否RCodeInt失敗原因OShipperShipperCodeString快遞公司編碼OShipperNameString快遞公司名稱O
三、示例
請求示例 JSON
{ "LogisticCode": "3967950525457" }
返回示例 JSON
{
"EBusinessID": "1257021",
"Success": true,
"LogisticCode": "3967950525457",
"Shippers": [
{
"ShipperCode": "YD",
"ShipperName": "韻達快遞"
}
]
}
demo下載地址:
接口接入技術文檔
點擊獲取文檔
單號識別接口Demo工具.NET版
單號識別接口Demo工具.PHP版
單號識別接口Demo工具.JAVA版
接入流程
1、登錄快遞鳥官網註冊頁面註冊快遞鳥賬號
網址:快遞單號查詢接口_電子面單_APIKey授權申請-快遞鳥賬號註冊
2、登錄快遞鳥用戶管理後臺
注:登錄快遞鳥用戶管理後臺後獲得用戶ID和APIKey,此用於保證應用來源的可靠性,避免應用僞造,被不法使用。
3、進入“我的會員中心”進行實名認證
注:
3.1、認證類型、應用類型根據用戶實際情況選擇即可,接口返回數據與選擇結果無關;
3.2、標記爲*的爲必填,要求上傳清晰、jpg格式且小於2M的證件圖片;
3.3、技術對接人信息爲用戶方對接工程師的信息;
3.4、如有其他疑問可進入官網加入商務合作羣進行諮詢。
認證成功後,進入“產品服務管理”,開通相關會員服務
注:
物流查詢(免費版)會員套餐爲免費版,有效期1年結束後,如在近3個月內有數據交互系統會自動免費續期;
4、單號識別接口對接重點說明(RequestType:2002)
請求接口之前需要先實名認證,開通相關會員服務,否則會請求失敗並返回提示“未申請開通接口”;
接口開發可以下載“快遞鳥接口技術文檔”進行參考;單號識別,參考技術文檔中的4.4部分;
接口開發可以下載“單號識別demo”進行參考(僅提供了.NET、Java、PHP三種語言的demo);使用其他語言開發的用戶需按照技術文檔自行開發;
接入過程中如有疑問請先參考快遞鳥官網常見問題進行解決(http://www.kdniao.com/help),也可以進入快遞鳥官網加入技術對接羣進行諮詢。
注:快遞鳥官網-幫助與文檔地址(http://www.kdniao.com/documents)