應用場景

物流訂閱介面，可根據開發者提交的運單號，實時監控包裹的物流軌跡，在獲取最新物流狀態後，快寶網路實時通過回撥地址推送給開發者，直到運單號對應包裹完成簽收。當前支援訂閱的快遞品牌均為快遞公司總部直接合作，與對應快遞官網資料同步更新，現支援訂閱快遞為：中通快遞、申通快遞、圓通速遞、韻達快遞、德邦快遞、極兔速遞（含百世快遞）

1、電商網站對發貨包裹進行物流追蹤，實時展示最新物流狀態給使用者

2、物流管理系統，監控所有包裹實時狀態，可進行視覺化管理

3、涉及物流的相關公眾號、小程式、APP，可實時推送物流狀態變更資訊，增強購買體驗，留存客戶

4、發貨企業可根據接收“已簽收”狀態，作為訂單完結節點及收款依據

5、根據不同快遞公司的物流狀態變更資訊，可預估快遞公司時效，合理配置發貨快遞

6、電商客服可批量跟蹤“派件中”、“已簽收”、“問題件”等狀態的單號，方便跟單及通知收貨

主要功能

實時監控：實時監控物流軌跡，監控物流狀態變更，獲取最新狀態後實時推送，直到快遞簽收

品牌覆蓋：支援常用主流快遞品牌查詢，物流軌跡全面

免費查詢：支援日免費查詢

效能穩定：日查詢過億，效能穩定

資料安全：三級等保資質，與快遞公司直連，安全閉環

介面名稱

express.sub.msg

公共引數

請求地址

環境名稱	HTTPS請求地址
正式地址

公共請求引數

名稱	型別	是否必須	描述
method	string	是	API介面名稱
app_id	string	是	使用者ID（註冊開放平臺時分配，在控制檯中檢視）
sign	string	是	按照規則(md5(app_id + method + ts + api_key))生成的合法性驗證簽名(32位字串，字母小寫)如:10000cloud.print.do1524209949bdf3b5f50865ac813cbdfd6c9b572b79加密後5030cae3388ecdc2e686379753a0564c
ts	string	是	當前請求的時間戳(10位或13位)
data	string	是	JSON格式請求引數

公共響應引數

名稱	型別	是否必須	描述
code	int	是	響應狀態碼。0-成功，非0-失敗下載並檢視詳情
msg	string	是	返回結果說明
uid	string	是	本次請求唯一業務流水號
data	string	是	JSON格式響應資料

請求引數

名稱	型別	是否必須	描述
waybill_codes	string	是	運單號，多個單號之間用","隔開（英文逗號），最多支援10條
cp_code	string	是	運單號所屬快遞品牌，須傳簡稱；申通快遞（sto）、中通快遞（zt）、圓通速遞（ytsd）、極兔速遞（jt）、韻達快遞（yd）、德邦快遞(dbkd)

響應引數

名稱	型別	是否必須	描述

暫無資料

回撥引數

名稱	型別	是否必須	描述
type	string	是	回撥型別：express_sub_msg
data	array	是	物流訂閱資訊

快寶物流訂閱介面文件