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

API服務

預約取件API

首頁 > API文檔 > 快遞查詢API

快遞查詢API

申請API

快遞查詢API，供小程序、APP、需實時返回物流軌跡信息即查即走，快遞查詢將提供輸入運單編號立即獲取物流最新軌跡，無需快遞編碼，自動識別物流公司，返回物流軌跡。

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

應用場景

（1）在移動端APP、小程序上輸入框與查詢按鈕，實現即時物流信息查詢。
（2）在網頁上使用輸入框與查詢按鈕，實現即時物流信息查詢。
（3）主流快遞公司，無需傳快遞編碼，自動識別物流公司返回物流軌跡。

功能說明

使用流程

API參數

一、接口描述/說明

（1）查詢接口支持按照運單號查詢(單個查詢)。
（2）接口需要指定快遞單號，格式不對或則編碼錯誤都會返失敗的信息。主流13家不需要選擇快遞公司編碼，其他需要選擇快遞公司編碼，查看快遞公司編碼。
（3）返回的物流跟蹤信息按照發生的時間升序排列。
（4）接口指令8002。
（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	請求指令類型：8002	是
DataSign	String	數據內容簽名：把(請求內容(未編碼)+AppKey)進行MD5加密，然后Base64編碼，最后進行URL(utf-8)編碼。詳細過程請查看Demo。	是
DataType	String	請求、返回數據類型：2-json；	否

二、接口參數

請求內容字段定義：

參數名稱	類型	說明	必須要求
OrderCode	String	訂單編號	否
CustomerName	String	ShipperCode 為JD，必填，對應京東的青龍配送編碼，也叫商家編碼，格式：數字＋字母＋數字，9 位數字加一個字母，共10 位，舉例：001K123450；ShipperCode 為SF，且快遞單號非快遞鳥渠道返回時，必填，對應收件人/寄件人手機號后四位；ShipperCode 為SF，且快遞單號為快遞鳥渠道返回時，不填；ShipperCode 為其他快遞時，不填	可選
ShipperCode	String	快遞公司編碼	否
LogisticCode	String	物流單號	是

返回參數定義：

參數名稱	類型	說明	必須要求
EBusinessID	String	用戶ID	是
OrderCode	String	訂單編號	否
ShipperCode	String	快遞公司編碼	是
LogisticCode	String	物流運單號	否
Success	Bool	成功與否	是
Reason	String	失敗原因	否
State	String	物流狀態：0-暫無軌跡信息,1-已攬收,2-在途中,3-簽收,4-問題件	是
StateEx	String	增值物流狀態： 0-暫無軌跡信息 1-已攬收 2-在途中 201-到達派件城市, 202-派件中, 211-已放入快遞柜或驛站, 3-已簽收 301-正常簽收, 302-派件異常后最終簽收, 304-代收簽收, 311-快遞柜或驛站簽收, 4-問題件 401-發貨無信息, 402-超時未簽收, 403-超時未更新, 404-拒收(退件), 405-派件異常, 406-退貨簽收, 407-退貨未簽收, 412-快遞柜或驛站超時未取	是
Location	String	所在城市	是
Traces.AcceptTime	String	時間	是
Traces.AcceptStation	String	描述	是
Traces.Action	String	當前狀態(同StateEx)	是
Traces.Location	String	所在城市	是
Traces.Remark	String	備注	否

三、示例

請求示例 JSON

{
    "LogisticCode":"772004651594875"
}

返回示例 JSON

沒有物流軌跡的
{
    "LogisticCode":"7720046515948751",
    "Traces":[

    ],
    "State":"0",
    "EBusinessID":"1470400",
    "Reason":"暫無軌跡信息",
    "Success":true
}
        有物流軌跡的
{
    "StateEx":"2",
    "LogisticCode":"3103630045838",
    "ShipperCode":"YD",
    "Traces":[
        {
            "Action":"1",
            "AcceptStation":"【深圳市】廣東深圳公司中心分撥分部 已攬收",
            "AcceptTime":"2020-06-17 03:31:04",
            "Location":"深圳市"
        },
        {
            "Action":"2",
            "AcceptStation":"【深圳市】已離開 廣東深圳公司中心分撥分部；發往 上海分撥中心",
            "AcceptTime":"2020-06-17 03:34:08",
            "Location":"深圳市"
        },
        {
            "Action":"2",
            "AcceptStation":"【深圳市】廣東深圳公司 已攬收",
            "AcceptTime":"2020-06-17 03:37:46",
            "Location":"深圳市"
        },
        {
            "Action":"2",
            "AcceptStation":"【深圳市】已到達 廣東深圳公司",
            "AcceptTime":"2020-06-17 08:02:33",
            "Location":"深圳市"
        },
        {
            "Action":"2",
            "AcceptStation":"【深圳市】已離開 廣東深圳公司；發往 上海分撥中心",
            "AcceptTime":"2020-06-17 08:11:33",
            "Location":"深圳市"
        },
        {
            "Action":"2",
            "AcceptStation":"【深圳市】廣東深圳公司福田區水圍站分部 已攬收",
            "AcceptTime":"2020-06-17 09:22:25",
            "Location":"深圳市"
        }
    ],
    "State":"2",
    "EBusinessID":"1470400",
    "Success":true,
    "Location":"深圳市"
}

接入流程