快遞鳥一次性對接2000+物流接口

API服務

預約取件API

首頁 > API文檔 > 即時查詢API

即時查詢API

申請API

物流查詢API提供實時查詢物流軌跡的服務，用戶提供運單號和快遞公司，即可查詢當前時刻的最新物流軌跡。

應用場景功能說明使用流程 API參數接入流程 demo下載

應用場景

（1）電商網站用戶打開“我的訂單”時調用此API顯示物流信息詳情。
（2）電商管理后臺的物流系統，客服在對賬前查詢所有運單的簽收狀態，并追蹤問題。
（3）每日調用次數限制不超過500次，如超過該限制，請對接物流跟蹤API。
（4）全流程的物流狀態跟蹤，即時查詢無限次，請對接在途監控API

功能說明

使用流程

API參數

一、接口描述/說明

（1）查詢接口支持按照運單號查詢(單個查詢)。
（2）接口需要指定快遞單號的快遞公司編碼，格式不對或則編碼錯誤都會返失敗的信息。
如：EMS物流單號應選擇快遞公司編碼（EMS）查看快遞公司編碼
（3）返回的物流跟蹤信息按照發生的時間升序排列。
（4）接口指令1002。
（5）接口支持的消息接收方式為HTTP POST，請求方法的編碼格式(utf-8)："application/x-www-form-urlencoded;charset=utf-8"。
（6）測試地址：http://sandboxapi.kdniao.com:8080/kdniaosandbox/gateway/exterfaceInvoke.json
（7）正式地址：https://api.kdniao.com/Ebusiness/EbusinessOrderHandle.aspx

請求系統級參數說明：

參數名稱	類型	說明	必須要求
RequestData	String	請求內容需進行URL(utf-8)編碼。請求內容JSON格式，須和DataType一致。	是
EBusinessID	String	商戶ID，請在我的服務頁面查看。	是
RequestType	String	請求指令類型：1002	是
DataSign	String	數據內容簽名：把(請求內容(未編碼)+AppKey)進行MD5加密，然后Base64編碼，最后進行URL(utf-8)編碼。詳細過程請查看Demo。	是
DataType	String	請求、返回數據類型：2-json；	否

二、接口參數

請求內容字段定義：

參數名稱	類型	說明	必須要求
OrderCode	String	訂單編號	否
ShipperCode	String	快遞公司編碼	是
LogisticCode	String	物流單號	是

返回參數定義：

參數名稱	類型	說明	必須要求
EBusinessID	String	用戶ID	是
OrderCode	String	訂單編號	否
ShipperCode	String	快遞公司編碼	是
LogisticCode	String	物流運單號	否
Success	Bool	成功與否	是
Reason	String	失敗原因	否
State	String	物流狀態：2-在途中,3-簽收,4-問題件	是
Traces
AcceptTime	String	時間	是
AcceptStation	String	描述	是
Remark	String	備注	否

三、示例

請求示例 JSON

{
                "OrderCode": "",
                "ShipperCode": "SF",
                "LogisticCode": "118650888018"
                }

返回示例 JSON

沒有物流軌跡的
        {
        "EBusinessID": "1109259",
        "Traces": [],
        "OrderCode": "",
        "ShipperCode": "SF",
        "LogisticCode": "118461988807",
        "Success": false,
        "Reason": null
        }
        有物流軌跡的
        {
        "EBusinessID": "1109259",
        "OrderCode": "",
        "ShipperCode": "SF",
        "LogisticCode": "118461988807",
        "Success": true,
        "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/25 01: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
        }
        ]
        }

接入流程