首頁 > API文檔 > 即時查詢API
即時查詢API
申請API
物流查詢API提供實時查詢物流軌跡的服務,用戶提供運單號和快遞公司,即可查詢當前時刻的最新物流軌跡。
應用場景
(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)測試地址://sandboxapi.www.sidaiy.com.cn:8080/kdniaosandbox/gateway/exterfaceInvoke.json
(7)正式地址://api.kdniao.com/Ebusiness/EbusinessOrderHandle.aspx
請求系統級參數說明:
參數名稱類型說明必須要求
RequestDataString請求內容需進行URL(utf-8)編碼。請求內容JSON格式,須和DataType一致。R
EBusinessIDString商戶ID,請在我的服務頁面查看。R
RequestTypeString請求指令類型:1002R
DataSignString數據內容簽名:把(請求內容(未編碼)+AppKey)進行MD5加密,然后Base64編碼,最后 進行URL(utf-8)編碼。詳細過程請查看Demo。R
DataTypeString請求、返回數據類型:2-json;O
備注:R-必填(Required),O-可?。∣ptional),C-報文中該參數在一定條件下可?。–onditional)
二、接口參數
請求內容字段定義:
參數名稱類型說明必須要求
OrderCodeString訂單編號O
ShipperCodeString快遞公司編碼R
LogisticCodeString物流單號R
返回參數定義:
參數名稱類型說明必須要求
EBusinessIDString用戶IDR
OrderCodeString訂單編號O
ShipperCodeString快遞公司編碼R
LogisticCodeString物流運單號O
SuccessBool成功與否R
ReasonString失敗原因O
StateString物流狀態:2-在途中,3-簽收,4-問題件R
Traces
AcceptTimeString時間R
AcceptStationString描述R
RemarkString備注O
三、示例
請求示例 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
        }
        ]
        }
接入流程
demo下載

相關文檔與更多幫助?

30萬+
數十萬客戶的選擇
5.8億次+
日均處理物流數據次數
1450萬+
日均千萬訂單數據處理
600家+
支持全國600+家物流商
在線咨詢
商務合作群:
783245476
技術對接群14:
665031725
排三组选370前后关系
400-9633321
免費獲取API