有赞iPaaS接口接入指南

1. 准备工作

1.1 环境要求

JDK版本要求：1.8及以上

1.2 获取必要参数

调用前需要准备以下参数：

host: iPaaS应用的对外请求域名（区分开发和生产环境）

app-id: 系统打通标识ID（格式：{{有赞商城总店ID}}_{{厂商连接器的英文名}}）

privateKey: 私钥（用于接口调用签名）

获取方式请参考下图指导（可在集成方案页面获取到对应信息）：

2. 项目配置

2.1 最新版本

当前最新版本: 2.7.16-RELEASE

版本更新: 版本号会持续更新，请关注官方发布

2.2 Maven依赖配置

推荐使用dependencyManagement管理版本：

<properties>
    <cloud-connector-sdk.version>2.6.69-RELEASE</cloud-connector-sdk.version>
</properties>

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.youzan</groupId>
            <artifactId>cloud-connector-sdk-dependencies</artifactId>
            <version>${cloud-connector-sdk.version}</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

<dependencies>
    <dependency>
        <groupId>com.squareup.okhttp3</groupId>
        <artifactId>okhttp</artifactId>
        <version>3.12.0</version>
    </dependency>
</dependencies>

2.3 直接下载JAR包

如不想使用Maven，可直接下载JAR包：
https://maven.youzanyun.com/#browse/browse:maven-releases:com%2Fyouzan%2Fcloud-connector-sdk-client%2F${cloud-connector-sdk.version}%2Fcloud-connector-sdk-client-${cloud-connector-sdk.version}.jar

注：请将连接中${cloud-connector-sdk.version}替换为具体的版本，如：2.7.16-RELEASE

3. 接口调用规范

3.1 请求格式

接口路径: /open/gateway/{接口名}/{版本号}

请求方法: POST

Content-Type: application/json

3.2 公共请求头参数

参数名	必填	说明
app-id	是	系统打通标识ID
ts	是	请求时间戳（毫秒），过期请求会被拦截
nonce	是	请求随机串
sign-type	是	加签算法类型，目前仅支持RSA
sign	是	签名结果

3.3 签名算法

收集所有Header中的公共参数

按照key的字母顺序排序

拼接成字符串

使用RSA私钥进行签名

具体实现参考：com.youzan.cloud.connector.sdk.client.utils.YzCloudSignature#rsaSign

4. 完整调用示例

5. 注意事项

密钥安全: 请妥善保管私钥，不要泄露给第三方

时间戳: 确保服务器时间准确，避免因时间差导致签名验证失败

随机串: 每次请求应使用不同的nonce值，防止重放攻击

错误处理: 建议添加完善的错误处理机制，对网络异常、签名验证失败等情况进行处理

6. 常见问题

6.1 签名验证失败怎么办？

检查私钥是否正确

确认时间戳是否在有效期内

验证参数拼接和签名算法是否正确

检查请求头参数是否完整

6.2 如何升级SDK版本？

更新properties中的版本号：

<cloud-connector-sdk.version>新版本号</cloud-connector-sdk.version>

📞 技术支持: 如遇到问题，请联系iPaaS技术支持团队获取帮助。

接入指南

有赞iPaaS接口接入指南#

1. 准备工作#

1.1 环境要求#

1.2 获取必要参数#

2. 项目配置#

2.1 最新版本#

2.2 Maven依赖配置#

2.3 直接下载JAR包#

3. 接口调用规范#

3.1 请求格式#

3.2 公共请求头参数#

3.3 签名算法#

4. 完整调用示例#

5. 注意事项#

6. 常见问题#

6.1 签名验证失败怎么办？#

6.2 如何升级SDK版本？#