如何利用快遞鳥提供的接口來查詢每天快遞的物流軌跡。json
咱們先來看一下,接口完成之後的實際顯示效果api
如下是產品應用截圖,調用快遞鳥接口得到的軌跡信息:
實際上快遞鳥返回的報文信息會更詳細,在給客戶展現的信息可根據產品須要來封裝返回軌跡信息。測試
如今咱們來聊一聊實現方式!ui
首先咱們準備好須要用到的資源,
測試商戶ID:編碼
test1617571spa
測試API key:3d
554343b2-7252-439b-b4eb-1af42c8f2175(此Key僅限測試環境使用)code
API測試地址:blog
http://sandboxapi.kdniao.com:8080/kdniaosandbox/gateway/exterfaceInvoke.json接口
接下來,咱們講解一下請求參數
1、接口描述/說明
請求系統級參數說明:
備註:R-必填(Required),O-可選(Optional),C-報文中該參數在必定條件下可選(Conditional)
這裏提到了系統級參數,也至關因而公用參數,這些參數是調用每一個接口都是必需要傳參的。
接口參數:
接口參數,也叫業務參數,請求的業務接口不一樣,參數的字段,內容也不一樣,是跟着業務變化的,這裏咱們實現的是即時查詢接口,請求指令類型:1002,快遞鳥官網要求必須傳遞快遞公司編碼和物流單號 ,每天快遞的編碼是HHTT
如要查看其餘快遞公司的編碼,點擊此連接:
http://www.kdniao.com/documents
咱們用每天快遞單號669537622442來完成軌跡查詢,
請求 JSON
{'OrderCode':'','ShipperCode':'HHTT','LogisticCode':'669537622442'}
請求的完整報文(URL編碼之後):
RequestData=%0d%0a++++++++++++%7b%27OrderCode%27%3a%27%27%2c%27ShipperCode%27%3a%27HHTT%27%2c%27LogisticCode%27%3a%27669537622442%27%7d%0d%0a++++++++&EBusinessID=1264783&RequestType=1002&DataSign=M2ZmMzhhZGM3ZDM4NDUyYjJhYzYyNzFiMDA3MGZmOGY%3d&DataType=2
未編碼的請求報文:
RequestData={'OrderCode':'','ShipperCode':'HHTT','LogisticCode':'669537622442'}&EBusinessID=1264783&RequestType=1002&DataSign=M2ZmMzhhZGM3ZDM4NDUyYjJhYzYyNzFiMDA3MGZmOGY=&DataType=2
返回報文信息
{
"LogisticCode": "669537622442", "ShipperCode": "HHTT", "Traces": [ { "AcceptStation": "[收件]【臨沂蘭山一分部0539-7970100】的蘭山一已收件", "AcceptTime": "2018-12-27 10:33:39" }, { "AcceptStation": "[到件]快件到達【臨沂分撥中心】", "AcceptTime": "2018-12-27 12:10:35" }, { "AcceptStation": "[發件]快件由【臨沂分撥中心】發往【曲阜分撥中心】", "AcceptTime": "2018-12-27 12:13:12" }, { "AcceptStation": "[到件]快件到達【曲阜分撥中心】", "AcceptTime": "2018-12-27 18:20:47" }, { "AcceptStation": "[發件]快件由【曲阜分撥中心】發往【武漢分撥中心】", "AcceptTime": "2018-12-27 18:22:06" }, { "AcceptStation": "[到件]快件到達【武漢分撥中心】", "AcceptTime": "2018-12-28 09:19:59" }, { "AcceptStation": "[到件]快件到達【武漢分撥中心】", "AcceptTime": "2018-12-28 09:20:09" }, { "AcceptStation": "[發件]快件由【武漢分撥中心】發往【長沙分撥中心】", "AcceptTime": "2018-12-28 09:24:23" }, { "AcceptStation": "[到件]快件到達【長沙分撥中心】", "AcceptTime": "2018-12-28 19:42:05" }, { "AcceptStation": "[發件]快件由【長沙分撥中心】發往【衡陽分撥中心】", "AcceptTime": "2018-12-28 19:48:42" }, { "AcceptStation": "[到件]快件到達【衡陽分撥中心】", "AcceptTime": "2018-12-29 02:43:31" }, { "AcceptStation": "[發件]快件由【衡陽分撥中心】發往【郴州】", "AcceptTime": "2018-12-29 02:46:06" }, { "AcceptStation": "[到件]快件到達【郴州18670529177】", "AcceptTime": "2018-12-29 08:54:42" }, { "AcceptStation": "[發件]快件由【郴州18670529177】發往【郴州香路路分部】", "AcceptTime": "2018-12-29 08:55:42" }, { "AcceptStation": "[到件]快件到達【郴州香路路分部】", "AcceptTime": "2018-12-29 10:38:56" }, { "AcceptStation": "[派件]【郴州香路路分部】的黃波1317035475813170354758正在派件", "AcceptTime": "2018-12-29 14:37:25" }, { "AcceptStation": "[簽收]親,您的快件投遞至商店,有疑問請聯繫【15115514458】/【郴州香路路分部】或致電總部服務熱線4001888888!每天快遞小哥誠邀您給個五星好評,謝謝!", "AcceptTime": "2018-12-29 21:17:56" } ], "State": "3", "EBusinessID": "1264783", "Success": true
}
這裏根據咱們的實際業務需求來選擇免費套餐或者收費套餐。
附上詳細的接口文檔給你們: