常用物流快遞單號查詢介面種類及對接方法

目前快遞查詢介面有兩種方式可以對接，一是和順豐、圓通、中通、天天、韻達、德邦這些快遞公司一一對接介面，二是和快遞鳥這樣第三方整合介面一次性對接多家常用快遞。第一種耗費時間長，但是是直接和快遞公司合作，第二種雖然是間接對接，但是對接簡便，對後期的介面維護可以省很多時間和人力成本。

整合介面還有其他公司提供，有其他需要可以去找，快遞鳥其實能滿足電商、erp系統商這些企業需求了。這裡就以快遞鳥為例說說對接方法。

快遞鳥物流查詢介面有免費和收費版本，對接週期大概在一天左右，他們有寫好的demo，可以直接使用。

一.即時查詢介面（免費）

介面規則

(1)、查詢介面支援按照運單號查詢(單個查詢，併發不超過10個/s)。

(2)、指定的物流運單號選擇相應的快遞公司編碼，格式不對或則編碼錯誤都會返失敗的資訊。如ems物流單號應選擇快遞公司編碼（ems）

(3)、返回的物流跟蹤資訊按照發生的時間公升序排列。

(4)、介面指令1002。

系統級和應用級輸入引數

3.返回結果引數

示例

//返回示例
//沒有物流軌跡的
//有物流軌跡的
, ,,,
,,]}

2.2接收介面

這個是使用者在訂閱單號成功且有物流軌跡更新後，快遞鳥的推送客戶通過下單、訂閱介面，把運單號在快遞鳥系統訂閱。運單物流資訊有更新，快遞鳥通過推送介面把更新的資訊推送給客戶。推送介面由使用者按照快遞鳥規則實現。商戶開放介面，快遞鳥定時將最新的物流軌跡推送到商戶平台。

優點：客戶不需要關注軌跡變化，一旦有更新，快遞鳥自動推送。

缺點：對客戶的伺服器效能有所要求，快遞鳥定時請求介面，對客戶的伺服器有一定的影響，客戶伺服器異常將接受不到最新資料。快遞鳥推送介面根據業務不同，會根據requesttype的分類推送不同的資料，使用者需對推送的資料進行分類儲存。原推送介面無需變化，快遞鳥會根據推送版本進行推送。

介面規則

(1)、客戶伺服器必須穩定，並且有一定的接受資料能力（需要在5s內給快遞鳥返回成功示例，超時會判斷推送失敗）。快遞鳥通過多執行緒推送物流資訊給客戶。

(2)、客戶需要按快遞鳥要求開發介面，保證資訊的正常接收。客戶接資料後，儲存並馬上返回接收響應。如果客戶對資料進行處理，再做出響應。這會造成網路超時，傳輸效率低下。 (3)、主動推送時物流資訊接收介面由客戶提供，介面必須按照快遞鳥的要求實現。

(4)、客戶提供介面位址，使用者登陸使用者管理後台-----除錯平台-----推送介面進行測試---（成功返回示例後）才可以配置。

(5)、介面只支援json資料格式。

(6)、post方式請求。

示例：

//快遞鳥請求接收介面示例
訂閱查詢結果示例：
, ,,,
,,,]
},,,,
,,,,
]}]}貨款狀態：
, ]}