調用快遞鳥提供的快遞查詢API標準接口,快速對接100多家快遞公司的物流軌跡查詢,本篇文章實現<優速快遞>的快遞單號查詢。json
首先咱們準備好須要用到的資源,api
這裏推薦你們去愛奇藝查看視頻教程:測試
測試商戶ID:ui
test1617571編碼
測試API key:spa
554343b2-7252-439b-b4eb-1af42c8f2175(此Key僅限測試環境使用)3d
API測試地址:code
http://sandboxapi.kdniao.com:8080/kdniaosandbox/gateway/exterfaceInvoke.json視頻
接下來,咱們講解一下請求參數blog
1、接口描述/說明
請求系統級參數說明:
備註:R-必填(Required),O-可選(Optional),C-報文中該參數在必定條件下可選(Conditional)
這裏提到了系統級參數,也至關因而公用參數,這些參數是調用每一個接口都是必需要傳參的。
接口參數:
接口參數,也叫業務參數,請求的業務接口不一樣,參數的字段,內容也不一樣,是跟着業務變化的,這裏咱們實現的是即時查詢接口,請求指令類型:1002,快遞鳥官網要求必須傳遞快遞公司編碼和物流單號 ,優速快遞的編碼是UC
如要查看其餘快遞公司的編碼,點擊此連接:
http://www.kdniao.com/documents
咱們用真實單號(900752733683)來完成軌跡接口調用,
請求 JSON
{'OrderCode':'','ShipperCode':UC,'LogisticCode':' 900752733683'}
請求的完整報文(URL編碼之後):
RequestData=%0d%0a++++++++++++%7b%27OrderCode%27%3a%27%27%2c%27ShipperCode%27%3a%27UC%27%2c%27LogisticCode%27%3a%27900752733683%27%7d%0d%0a++++++++&EBusinessID=1264783&RequestType=1002&DataSign=YzlhZDZmMTNkYWY5M2MxZTIxOTQ1MmUwMWRmZDdlNjc%3d&DataType=2
未編碼的請求報文:
{'OrderCode':'','ShipperCode':'UC','LogisticCode':'900752733683'} &EBusinessID=1264783&RequestType=1002&DataSign=YzlhZDZmMTNkYWY5M2MxZTIxOTQ1MmUwMWRmZDdlNjc=&DataType=2
返回報文信息
{
"LogisticCode": "900752733683", "ShipperCode": "UC", "Traces": [{ "AcceptStation": "[徐州十八部]【建華包裝】已收件", "AcceptTime": "2020-02-24 15:54:36" }, { "AcceptStation": "快件已到達[徐州快遞分撥],上一站是[徐州十八部]", "AcceptTime": "2020-02-24 18:25:55" }, { "AcceptStation": "快件已由[徐州快遞分撥]發往[無錫快遞分撥]", "AcceptTime": "2020-02-24 18:27:14" }, { "AcceptStation": "快件已到達[無錫快遞分撥],上一站是[徐州快遞分撥]", "AcceptTime": "2020-02-25 03:32:27" }, { "AcceptStation": "快件已由[無錫快遞分撥]發往[泰州快遞分撥]", "AcceptTime": "2020-02-25 03:34:40" }, { "AcceptStation": "快件已到達[泰州快遞分撥],上一站是[無錫快遞分撥]", "AcceptTime": "2020-02-25 08:29:43" }, { "AcceptStation": "快件已由[泰州快遞分撥]發往[姜堰六部]", "AcceptTime": "2020-02-25 08:31:16" }, { "AcceptStation": "快件已到達[姜堰六部],上一站是[泰州快遞分撥]", "AcceptTime": "2020-02-27 09:55:54" }, { "AcceptStation": "[姜堰六部]的【周國兵】正在派件, 電話:15996068855。小哥今日體溫正常,將佩戴口罩爲您服務,也能夠聯繫小哥將您的包裹放到指定點,祝您身體健康!", "AcceptTime": "2020-02-27 10:04:37" }, { "AcceptStation": "快件已本人簽收", "AcceptTime": "2020-02-27 14:46:31" }], "State": "3", "EBusinessID": "1264783", "Success": true
}
附上詳細的接口文檔給你們: