首页 > 技术文章 > 银联沙箱测试,轻松体验API接入流程

ummi 2019-05-10 14:55 原文

 

引言:我为大家带来了银联开放平台开放API版块的沙箱测试,这里以“银行卡信息查询”为例,带你体验相关API的接入流程!

 

沙箱测试

沙箱是为了开发与调试所提供的环境,开发测试阶段,应用需要在沙箱环境下进行开发,它与生产环境互相隔离,同时为了便于用户进行体验,申请沙箱测试后用户可通过在线演示填写所需要的参数进行接口调用的模拟和体验。

 

如何申请沙箱测试?

进入产品API详情页面(点击进入),点击沙箱测试进行申请  

 

在线调试(银行卡信息查询为例)

  1. 点击沙箱调用进入功能界面(需先点击上方的沙箱测试申请权限)

 

界面如下

 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栏中并点击发送请求

返回结果如下

 

以上就是沙箱测试环境下的在线演示流程.

推荐阅读