接口调用

HTTP调用方式可以面向HTTP接口进行开发，ISV可以根据自己系统的情况，选择不同的实现语言来实现对接。

📌

本文档描述了如何对接本平台开放接口加解密格式，后续业务接口不在体现加解密格式，只体现业务报文格式

1. 协议概述

传输协议: HTTPS

请求方式: POST

数据格式: JSON

字符编码: UTF-8

2. 安全机制

本平台采用 AES加密 + MD5签名 的安全机制。

2.1 加密算法 (AES)

请求体和响应体均采用 AES 对称加密。

算法: AES

模式: ECB

填充: PKCS5Padding

密钥 (appkey): 平台分配的密钥字符串 (取前16位作为AES Key)

2.2 签名算法 (MD5)

请求头中的 sign 字段用于校验请求合法性。

签名规则:
sign = MD5(appid + nonce + payload + timestamp + appkey).toUpperCase()

注意: 参数顺序固定，payload 为加密后的密文串。

3. 报文格式

3.1 请求结构

HTTP Header:

字段名	说明	示例
`Content-Type`	固定值	`application/json;charset=utf-8`
`appid`	应用ID	`your_app_id`
`timestamp`	毫秒级时间戳	`1706496000000`
`nonce`	随机串（长度16）	`random_string`
`sign`	签名串	`MD5_UPPERCASE`

HTTP Body:

{
    "payload": "AES加密后的业务参数JSON字符串"
}

3.2 响应结构

HTTP Header:
包含与请求相同的 appid, timestamp, nonce, sign 用于客户端验签。

HTTP Body:

{
    "payload": "AES加密后的响应结果JSON字符串"
}

4. 业务接口定义

以下为 加密前 的业务参数 (JSON)。

示例：银行卡四要素认证

URL: /api/auth/bank-card

描述: 验证姓名+身份证+银行卡+手机号是否匹配。

请求参数:

字段名	类型	必填	说明
`name`	String	是	姓名
`certNo`	String	是	身份证号
`cardNo`	String	是	银行卡号
`phoneNo`	String	是	银行预留手机号
`certType`	String	否	证件类型 (默认 01:身份证)

5. Java SDK (客户端工具类)

可直接使用以下工具类进行加密和签名。依赖 hutool-all。

<dependency>
    <groupId>cn.hutool</groupId>
    <artifactId>hutool-all</artifactId>
    <version>5.8.26</version>
</dependency>

1. 协议概述#

2. 安全机制#

2.1 加密算法 (AES)#

2.2 签名算法 (MD5)#

3. 报文格式#

3.1 请求结构#

3.2 响应结构#

4. 业务接口定义#

示例：银行卡四要素认证#

5. Java SDK (客户端工具类)#