1. 程式人生 > >快遞物流資訊推送功能分析

快遞物流資訊推送功能分析

之前有文章分析過快遞物流資訊的實時查詢API接入,詳細的介紹內容可以去這個地址逛逛:http://blog.csdn.net/cn_oo/article/details/52084926

這裡就介紹一下快遞物流資訊的推送功能的介面對接分析:

1.首先簡單用一個簡單的示意圖分析一下(個人做的,比較粗略):

快遞資訊推送服務由訂單訂閱、跟蹤系統和訂單推送組成。使用者系統通過呼叫訂單訂閱,將要需要跟蹤的運單號提交給查詢服務商,查詢服務商在接收到運單資訊之後就會對這些運單的狀態進行跟蹤。當運單狀態發生變化的時候,便通過呼叫訂單推送功能,將快遞單查詢結果推送給使用者系統,直到該運單號的生命週期結束(通常情況下以“已簽收”為準)。

2.訂單訂閱介面協議

以市面上其中某一家查詢服務商為例

2.1訂閱請求

發起方:使用者系統

地址:http://highapi.kuaidi.com/openapi-receive.html

通訊協議:HTTP

請求型別:POST

字符集:utf-8

請求內容:

param=body

要傳入內容,只顯示核心的欄位,非核心的已隱藏

Body格式(json)

{

"company":"yuantong",//訂閱的快遞公司的編碼,一律用小寫字母,

"number":"12345678", //訂閱的快遞單號,單號的最大長度是32個字元

"from":"廣東深圳",//出發地城市

"to":"北京朝陽",

//目的地城市,到達目的地後會加大監控頻率

"key":"*********",//授權碼,需要聯絡查詢服務商註冊賬號ID

"parameters":{

"callbackurl":"http://www.您的域名.com/kuaidi?callbackid=...",//回撥地址

"salt":"any string",//簽名用隨機字串(可選)

}

}

2.2訂閱返回

由查詢服務商直接通過訂閱請求的response返回。

返回內容,只顯示核心的欄位,非核心的已隱藏(以JSON為例)

"message":"success"


備註:

更多的詳細的內容不在這裡過多的寫了,有需要了解的我會上傳到網盤,可自行下載檢視,下載地址為:https://pan.baidu.com/s/1mhMmlNa

下載文件裡附帶有快遞公司的簡碼列表。

如果有什麼不清楚的地方,請到快遞網的官網諮詢(http://www.kuaidi.com/),或者撥打快遞網諮詢電話:18205167920  或加qq:2885643506  發郵件至[email protected]