快遞物流資訊推送功能分析
之前有文章分析過快遞物流資訊的實時查詢API接入,詳細的介紹內容可以去這個地址逛逛:http://blog.csdn.net/cn_oo/article/details/52084926
這裡就介紹一下快遞物流資訊的推送功能的介面對接分析:
1.首先簡單用一個簡單的示意圖分析一下(個人做的,比較粗略):
快遞資訊推送服務由訂單訂閱、跟蹤系統和訂單推送組成。使用者系統通過呼叫訂單訂閱,將要需要跟蹤的運單號提交給查詢服務商,查詢服務商在接收到運單資訊之後就會對這些運單的狀態進行跟蹤。當運單狀態發生變化的時候,便通過呼叫訂單推送功能,將快遞單查詢結果推送給使用者系統,直到該運單號的生命週期結束(通常情況下以“已簽收”為準)。
以市面上其中某一家查詢服務商為例
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]