本篇文章1708字,读完约4分钟

阿里云国际站经销商,主营阿里云,腾讯云,华为云,亚马逊aws,谷歌云gcp,微软云az,免费开户,代充值优惠大,联系客服飞机@jkkddd

接入ZOLOZ 网关

ZOLOZ API独立于编程语言并由网关服务对外开放。在接入ZOLOZ API之前,您需要确保可以与ZOLOZ网关服务进行通信。本文介绍使用Java库或ZOLOZ辅助脚本接入ZOLOZ API的方法,以及如果是自行实现的网关协议,如何使用ZOLOZ辅助脚本来验证自己的实现。
前提条件
网关服务基于网关协议而实现,请确保您已了解ZOLOZ网关协议。
您已获取与网关服务通信时使用的API凭证,请参见获取API凭证。
接入方法
要实现与网关服务通信,一是可以集成已有的网关协议库,二是自行实现网关协议。
ZOLOZ提供多个库供您根据您的编程语言和环境进行选择。
Java库:当您的编程语言是Java时使用此库,请参见添加Java库。
辅助脚本:当您需要直接从shell调用ZOLZO API时使用此shell脚本,请参见使用辅助脚本。
如果您是自行实现的网关协议,也可以使用ZOLOZ辅助脚本来验证自己的实现,请参见自行实现网关协议进行接入。
Authentication test API说明
本文使用Authentication test API进行演示。Authentication test API是一个特殊的API,与特定产品无关,用于身份验证测试。Authentication test API支持所有有效的JSON对象,并返回相同的JSON对象,类似echo命令。
和其他API 一样,Authentication test API也建立在网关服务之上,当您成功地调用Authentication test API后,集成其他API将非常简单。
方法一:通过已有库接入ZOLOZ API
添加Java库
ZOLOZ Java库发布在Maven中央存储库中。以下介绍如何使用公共Java库与网关服务交互并调用ZOLOZ API。
引入API SDK。
在项目的POM文件中添加以下依赖项,将库引入项目中。如需获取最新版本的依赖项,请单击这里。
您需要将代码中的以下字段替换成您的真实信息。如需获取clientId、zolozPublicKey、merchantPrivateKey,请参见获取API凭证。
clientId:客户ID。
zolozPublicKey:ZOLOZ交易公钥,采用Base64编码格式。
merchantPrivateKey:商户交易私钥,采用Base64编码格式。
setHostUrl:ZOLOZ网关URL,如需获取ZOLOZ网关URL,请参见选择站点和环境。
调用ZOLOZ API。
上述代码中使用的示例值仅供参考,在实际使用过程中,您需要将以下字段替换成您的真实信息。如需获取客户ID、ZOLOZ交易公钥,请参见获取API凭证。
-c:指客户ID。
-P:指商户交易私钥。代码中的“merchant_private_key.pem”是私钥的示例值,您需要将其替换为商户交易私钥的真实路径。
-K:指ZOLOZ交易公钥。
-a:指API的路径,上述代码中为演示指定了身份验证测试API。
-d:指请求的内容。
除了上面列出的选项外,您还可以根据需要添加以下选项:
-e:禁用加密。
-i:跳过响应签名验证。
方法二:自行实现网关协议进行接入
您可以自行实现网关协议来接入ZOLOZ API,接入后您可以根据以下方法通过ZOLOZ辅助脚本来验证接入结果。
执行您的实现类来调用API,并记录流程详细信息。
需要记录的信息如下:
通话中使用的请求时间
用于请求加密随机生成的AES密钥
加密的请求内容请求签名
调用辅助脚本以使用相同的请求调用相同的API,并添加以下选项。
v或-vv:打印详细信息供后续验证。
-t <request time>:将请求时间指定为步骤1中调用API请求的时间。
-k <AES128 key>:指定AES128作为步骤1中使用的密钥来加密请求内容。
以下示例介绍了如何运行脚本。