前沿
快遞鳥是一家聚合類的第三方快遞物流平台,目前該平台提供的産品主要以API為主。由于API不能直覺的看到産品效果,需要進行API對接聯調成功後才能真實的看到産品的實際效果。但是如果一上來就寫代碼進行對接,耗費的時間長不說,而且還得會寫代碼才行,對前期的調研很不劃算。本文主要示範如何使用Postman簡單又快速的調用快遞鳥API接口服務,非技術人員也可實作,真實體驗産品,如符合需求後再進行代碼項目對接,友善又快速。
1、新增賬號
在調用快遞鳥API之前需要先登入快遞鳥使用者中心擷取對應的使用者ID和Key,用于接口調用的鑒權,如果未注冊過快遞鳥賬号,可先通路快遞鳥注冊頁面進行賬号注冊,賬号注冊成功後可在使用者中心檢視獲得使用者ID和Key,使用ID和Key即可進行調用。
2、申請新客福利,開通14天免費試用套餐
登入使用者中心,申請新客福利,免費14試用,如下圖:
3、Postman參數設定
第一步、根據快遞鳥提供的技術文檔設定URL和Body參數,在這裡參數的設定采用變量的方式,友善後續調用不同接口時在統一界面更改,不用來回切換設定參數。如下圖:重點關注紅框處
第二步、編寫Postman中Pre-request Script腳本
具體代碼如下:
點選檢視代碼
var base64EncodeChars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
//base64編碼方法
function base64encode(str) {
var out, i, len;
var c1, c2, c3;
len = str.length;
i = 0;
out = "";
while (i < len) {
c1 = str.charCodeAt(i++) & 0xff;
if (i == len) {
out += base64EncodeChars.charAt(c1 >> 2);
out += base64EncodeChars.charAt((c1 & 0x3) << 4);
out += "==";
break;
}
c2 = str.charCodeAt(i++);
if (i == len) {
out += base64EncodeChars.charAt(c1 >> 2);
out += base64EncodeChars.charAt(((c1 & 0x3) << 4) | ((c2 & 0xF0) >> 4));
out += base64EncodeChars.charAt((c2 & 0xF) << 2);
out += "=";
break;
}
c3 = str.charCodeAt(i++);
out += base64EncodeChars.charAt(c1 >> 2);
out += base64EncodeChars.charAt(((c1 & 0x3) << 4) | ((c2 & 0xF0) >> 4));
out += base64EncodeChars.charAt(((c2 & 0xF) << 2) | ((c3 & 0xC0) >> 6));
out += base64EncodeChars.charAt(c3 & 0x3F);
}
return out;
}
//使用者ID和Key,實際調用需切換成自己的ID和Key,以下ID和Key僅做展示使用,無法正常調用接口
var key='fedb1da4-2ab8-161d-a35a-739d4f0fe01f';
var eBusinessID=1345678;
//接口指令
var requestType='8001';
//傳回結果的格式,目前隻支援Json格式,是以傳遞固定值2即可
var dataType=2;
//應用級參數,不同接口的應用級參數不一樣,具體參考技術文檔
var requestData='{"ShipperCode":"YD","LogisticCode":"432559258880074"}';
//生成簽名串,把(請求内容(未編碼)+ApiKey)進行MD5加密,然後Base64編碼,最後進行URL(utf-8)編碼
var dataSign = encodeURIComponent(base64encode(CryptoJS.MD5(requestData + key).toString()));
//url編碼請求資料
requestData = encodeURIComponent(requestData);
//系統級參數指派
postman.setGlobalVariable("EBusinessID", eBusinessID);
postman.setGlobalVariable("RequestType", requestType);
postman.setGlobalVariable("DataType", dataType);
postman.setGlobalVariable("RequestData", requestData);
postman.setGlobalVariable("DataSign", dataSign);
4、調用擷取結果
參數配置完成後點選Postman的Send按鈕,發送請求即可獲得結果,如下圖:
5、總結
完成上述動作後即可完成對快遞鳥單個接口的調用和檢視傳回結果,如果需要調用其他接口,隻需更改即可指令(requestType)和應用級參數(requestData)即可。同理,對接其他平台API時也可使用此方法,隻是編寫腳本要根據對接平台實際文檔修改即可。
如果對您有幫助勞煩幫忙點個贊,收藏關注一下,可以互相學習共同進步。
本文來自部落格園,作者:華小睿,轉載請注明原文連結:https://www.cnblogs.com/huaxiaorui/p/16646599.html