引言:我為大家帶來了銀聯開放平台開放API版塊的沙箱測試,這里以“銀行卡信息查詢”為例,帶你體驗相關API的接入流程!
沙箱測試
沙箱是為了開發與調試所提供的環境,開發測試階段,應用需要在沙箱環境下進行開發,它與生產環境互相隔離,同時為了便於用戶進行體驗,申請沙箱測試后用戶可通過在線演示填寫所需要的參數進行接口調用的模擬和體驗。
如何申請沙箱測試?
進入產品API詳情頁面(點擊進入),點擊沙箱測試進行申請
在線調試(銀行卡信息查詢為例)
- 點擊沙箱調用進入功能界面(需先點擊上方的沙箱測試申請權限)
界面如下
2.獲取API認證信息
登錄開放平台后進入個人中心-->我的信息進行API認證后生成“API認證賬號”和“API認證密鑰”,同時需自行設置“用戶簽名密鑰”和添加自己所需的IP到“用戶IP白名單”中去。
3.獲取Token
產品token是開放平台每個產品的全局唯一接口調用憑據,用戶調用各接口是都需要使用產品token
(1) 填寫URL參數
查看個人的API認證信息,將其復制到想要的文本框內,點擊發送請求即可生成
(2) 發送請求
發送請求后若出現相關錯誤,可根據提示或者參考應答碼進行調試修改
例如出現提示:您的IP(xxx.xxx.xxx.xxx)不屬於您設置的開發IP列表,只需要將此IP添加到用戶IP白名單中即可。
請求成功后便可獲取產品Token(有效期目前2個小時,需定時刷新,重新獲取將導致上次獲取的產品token失效)
具體示例如下:
4,銀行卡信息查詢
(1) 切換接口
(2)獲取時間戳
法1(推薦):使用當前頁面右側的演示小工具,點擊獲取時間戳即可自動生成並在下方以及左側文本框內自動填寫相關數據以供后續操作使用
法2:(JAVA): System.currentTimeMillis();
法3:通過網頁審查元素打開console控制台:new Date().getTime()
(3)獲取簽名信息
請求報文簽名規則:
a.報文前拼接簽名密鑰,后面拼接時間戳(毫秒)字符串:signature + body + ts ;
signature: 簽名密鑰;body: 請求JSON報文;ts: 時間戳,毫秒 ; 請求JSON報文體舉例:{"cardNo":"6214830215395277"}
(注:數字為所測試的銀行卡號)
b.使用SHA-256算法計算HASH值;
步驟1:先在頁面左側填寫銀行卡號
步驟2:點擊獲取時間戳
步驟3:修改簽名計算文本框內的[SIGNATURE]為自己設置的用戶簽名密鑰並點擊加密 (個人中心-我的信息(頁面底部)-API認證信息-用戶簽名密鑰(第三個))
注意:更改時應一並刪除[SIGNATURE]的括號
(4)填寫參數,發送請求 將上述所求各個參數填入,並點擊發送請求,便可得到請求結果,根據所輸入的銀行卡號,返回該卡號的相關信息:
若你按照上面的流程使用,在這一步中你只需要復制演示小工具右側加密過的字符串,粘貼到sign欄中並點擊發送請求
返回結果如下
以上就是沙箱測試環境下的在線演示流程.