【文章內(nèi)容簡介】 ： DataSign 生成后，對方接收到數(shù)據(jù)后，以同樣的算法進行簽名，生成摘要，對比兩者的摘要是否相同，如果不同，說明傳遞過程中發(fā)生數(shù)據(jù)篡改 。 快遞鳥 快遞接口技術(shù)文檔 8 注冊成為快遞鳥用戶后，會生成對應(yīng)的 沙箱 用戶 ID 和 APIKey， 用戶 ID 相當于用戶名，APIKey 相當于密碼。 舉例 ： RequestData (JSON)內(nèi)容為： {39。OrderCode39。:39。39。,39。ShipperCode39。:39。SF39。,39。LogisticCode39。:39。11895490757339。} 經(jīng)過 URL(UTF8)編碼的內(nèi)容為 ： %7b%27OrderCode%27%3a%27%27%2c%27ShipperCode%27%3a%27SF%27%2c%27LogisticCode%27%3a%27118954907573%27%7d； EBusinessID=1237100， APIKey=56da2cf8c8a244b2b6fa476cd7d1ba17 DataSign 簽名的 內(nèi)容為 {39。OrderCode39。:39。39。,39。ShipperCode39。:39。SF39。,39。LogisticCode39。:39。11895490757339。}56da2cf8c8a244b2b6fa476cd7d1ba17 經(jīng)過 md5 和 base64 后的內(nèi)容就為 ：OWFhM2I5N2ViM2U2MGRkMjc4YzU2NmVlZWI3ZDk0MmE=， 在經(jīng)過 URL(UTF8)編碼的內(nèi)容為 ：OWFhM2I5N2ViM2U2MGRkMjc4YzU2NmVlZWI3ZDk0MmE%3d 最終要發(fā)送的數(shù)據(jù)為 ： RequestType=1002amp。EBusinessID=1237100amp。RequestData =%7b%27OrderCode%27%3a%27%27%2c%27ShipperCode%27%3a%27SF%27%2c%27LogisticCode%27%3a%27118954907573%27%7d amp。DataSign =OWFhM2I5N2ViM2U2MGRkMjc4YzU2NmVlZWI3ZDk0MmE%3damp。 DataType=2 ，獲得 EBusinessID 和 RequestData 和 DataSign 等這幾個數(shù)據(jù)。 EBusinessID 得到 APIKey， RequestData+APIKey 的數(shù)據(jù)進行 md5 和 base64 后的內(nèi)容就為 OWFhM2I5N2ViM2U2MGRkMjc4YzU2NmVlZWI3ZDk0MmE= DataSign 是否一致，如果一致進行業(yè)務(wù)操作，如果不一致返回錯誤。 快遞鳥 快遞接口技術(shù)文檔 9 (C)DataSign 簽名加密代碼 ///summary ///電商 Sign 簽名 ////summary ///param name=content內(nèi)容 /param ///param name=keyValueAPIkey/param ///param name=charsetURL 編碼 /param ///returnsDataSign 簽名 /returns Public String Encrypt (String content, String keyValue, String charset) { if (keyValue != null) { return base64(MD5(content + keyValue, charset), charset)。 } return base64(MD5(content, charset), charset)。 } ///summary /// 字符串 MD5 加密 ////summary ///param name=Text要加密的字符串 /param ///returns密文 /returns Private string MD5(string Text, string charset) { byte[] buffer = (charset).GetBytes(Text)。 try { check。 check = new ()。 byte[] somme = (buffer)。 string ret = 。 foreach (byte a in somme) { if (a 16) ret += 0 + (X)。 else ret += (X)。 } return ()。 } catch { throw。 快遞鳥 快遞接口技術(shù)文檔 10 } } Private static string base64(String str, String charset) { ((charset).GetBytes(str))。 } 接入步驟 注冊賬號成為快遞鳥用戶 。 快遞鳥提供的 用戶 ID 是調(diào)用接口服務(wù)的身份證明，不可更改、不可轉(zhuǎn)用， API Key 是應(yīng)用訪問 API 的簽名附加密鑰，必須妥善保存。兩者關(guān)系類似于 用戶名 和密碼，兩者都會在簽名和業(yè)務(wù)參數(shù)中使用。 官網(wǎng)登 錄 網(wǎng)址 ： 官網(wǎng)注冊網(wǎng)址 ： 官網(wǎng)接口介紹網(wǎng)址 ： 獲取沙箱調(diào)試 UserID 和 Key /UserCenter/v2/SandBox/ ， 進行 實名認證， 并 開通 會員服務(wù) 。 進入調(diào)試平臺： 快遞鳥 快遞接口技術(shù)文檔 11 查看沙箱調(diào)試 UserID 和 Key: ； 快遞鳥提供各個 API接口的 DEMO(包括： .Net 版本、 Java版本、 PHP 版本 )供開發(fā)參考。 DEMO 下載地址： 。 注意 ： 1. 測試環(huán)境中 獲取 的測試快遞單號不可用于實際發(fā)貨。 2. 測試 UserID 和 AppKey 不能用于正式環(huán)境 API 調(diào)用 3. 部分接口需要開通相應(yīng)服務(wù)，請即時開通后方可使用。 4. 發(fā)布上線后請?zhí)鎿Q正式請求地址 、 UserID 和 AppKey 快遞鳥 快遞接口技術(shù)文檔 12 3 下單類接口 預(yù)約取件接口 功能說明 攬 件 。 ：保價、隱私面單、短信服務(wù)、代收貨款、貨款直退、貨款墊付。 用戶 快遞公司快遞鳥預(yù)約取件 預(yù)約取件快遞員按預(yù)約時間上門取件 基本信息 接口規(guī)則 ： 39。 amp。 + 。 。 派范圍，則無快遞員上門攬件。 戶原因?qū)е驴爝f公司投訴超過 3 次，快遞鳥將停用此用戶接口權(quán)限。 支持情況 支持預(yù)約取件的快遞公司：順豐、中通、百世、圓通、優(yōu)速、龍邦、韻達、快捷、天天、全峰、 EMS、安能。 應(yīng)用場景 電商平臺、打單工具、 ERP 系統(tǒng)、 WEB 端、 APP 移動端 接口指令 1001 請求方式 POST請求 支持格式 只支持 Json 格式、 UTF8 編碼 批量請求 不支持 接口地址 測試地址： 正式地址： 快遞鳥 快遞接口技術(shù)文檔 13 沙箱接口 響應(yīng)場景模擬規(guī)則 標志字段： OrderCode 值的規(guī)則 （當 OrderCode 傳如下面這些值時，能獲取到相應(yīng)的模擬響應(yīng)報文 ） ： 1. 1234560（模擬下單失敗的響應(yīng)） 2. 1234561（模擬下單成功的響應(yīng)） 3. 其它值（默認是下單成功的響應(yīng)） 應(yīng)用級參數(shù) 名稱 類型 (字符長 度 ) 是否必須 描述 WarehouseID String(50) O 倉庫標識 (備用字段 ) WarehouseAddress String(50) O 倉庫地址 (備用字段 ) CallBack String(50) O 用戶自定義回調(diào)信息 MemberID String(50) O 會員標識 (備用字段 ) ShipperCode String(20) R 快遞公司編碼 LogisticCode String(30) O 快遞單號 OrderCode String(30) R 訂單編號 (自定義，不 可重復(fù) ) PayType Int(1) R 運 費支付方式 : 1現(xiàn)付， 2到付， 3月結(jié)， 4第三方付 MonthCode String(20) C 月結(jié)編號 ExpType Int(2) R 快遞類型： 1標準快件 Cost Double(5) O 快遞運費 OtherCost Double(5) O 其他費用 String(30) O 收件人公司 String(30) R 收件人 String(20) R 電話與手機，必填一個 String(20) String(10) C 收件 地 郵編 (ShipperCode 為EMS、 YZPY 時必填 ) String(20) R 收件省 (如廣東省，不要缺少 “省 ”，如果是直轄市，請直接傳北京、 快遞鳥 快遞接口技術(shù)文檔 14 上海等 ) String(20) R 收件市 (如深圳市，不要缺少 “市 ”) String(20) O 收件區(qū) /縣 (如福田區(qū)，不要缺少“區(qū) ”或 “縣 ”) String(100) R 收件人詳細地址 String(30) O 發(fā)件人公司 String(30) R 發(fā)件人 String(20) R 電話與手機，必填一個 String(20) String(10) O 發(fā)件 地 郵編 (ShipperCode 為EMS、 YZPY 時必填 ) String(20) R 發(fā)件省 (如廣東省，不要缺少 “省 ”，如果是直轄市，請直接傳北京、上海等 ) String(20) R 發(fā)件市 (如深圳市，不要缺少 “市 ”) String(20) O 發(fā)件區(qū) /縣 (如福田區(qū)，不要缺少“區(qū) ”或 “縣 ”) String(100) R 發(fā)件人詳細地址 StartDate Date O 上門 攬件 時間段，格式：YYYYMMDD HH24:MM:SS EndDate Weight Double(10,3) O 包裹總重量 kg Quantity Int(2) O 包裹數(shù)，一個包裹對應(yīng)一個運單號，如果是大于 1 個包裹，返回則按照子母件的方式返回母運單號和子運單號 Volume Double(20,3) O 包裹總體積 m3 Remark String(100) O 備注 String(20) O 增值服務(wù)名稱 String(30) O 增值服務(wù)值 String(30) O 客戶標識 String(100) R 商品名稱 String(20) O 商品編碼 Int(5) O 商品件數(shù) 快遞鳥 快遞接口技術(shù)文檔 15 請求 示例 : { OrderCode: 012657018199, ShipperCode: SF, PayType: 1, MonthCode: 7553045845, ExpType: 1, Cost: , OtherCost: , Sender: { Company: LV, Name: Taylor, Mobile: 15018442396, ProvinceName: 上海 , CityName: 上海 , ExpAreaName: 青浦區(qū) , Address: 明珠路 }, Receiver: { Company: GCCUI, Name: Yann, Mobile: 15018442396, ProvinceName: 北京 , CityName: 北京 , ExpAreaName: 朝陽區(qū) , Address: 三里屯街道 }, Commodity: [ { G