1. 网关地址

测试环境：https://uat.qugongbao.com/gst-api
生产环境：https://api.qugongbao.com/gst-api

2. 协议规则

传输方式：采用 HTTPS 传输
提交方式：采用 POST 方法提交
数据结构：JSON
字符编码：采用 UTF-8 字符编码

3. 签名规则

签名验签步骤（body 加密[RAS+AES]）：

签名加密步骤:

使用 AES 加密算法对 body 参数进行加密

AES 密钥长度约定为 128 位

AES/ECB/PKCS5Padding 填充模式

body 加密后，转成 base64后参与加签

使用 RSA 算法对 AES 的密钥进行趣工宝公钥加密

AES key 转换成 16 进制之后，用 rsa 公钥加密.

用 RSA 客户私钥对参数签名后传输

将请求应答报文集合 M 排除字段值为空或 null的字段，按照属性名字母顺序，即按 ASCII 码从小到大排序（字典序）

使用 URL 键值对的格式（即 key1=value1&key2=value2…）拼接成字符串

对拼接的字符串做一次MD5 摘要

用客户RSA 私钥对 MD5 字符串加签。（生成签名）

请求示例

{
  "appId": "108120200417114401",
  "body": "rmgDGXwIwzYD4eCVPHkMsC3X4CO4WOZpeDTqSr6SCMSf3+s8FVlL9I8A3yIzWxF9",
  "encKey": "42F8F53E504930D5B49XXXXXXXXXXX",
  "reqNo": "da96f063a7f64866bdb71df9e9f9d27f",
  "signType": "SHA256WithRSA",
  "signValue": "AH0PYv3eFgqqle+jByFj6VWU8X7yuXXXXXXXX",
  "timestamp": "2024-01-30 10:28:29",
  "v": "2.0"
}

验签解密步骤：

使用趣工宝RSA公钥进行验签

取出加密AES密钥(encKey)用客户RSA私钥使用 RSA 算法进行解密

使用AES解密算法对body参数进行解密

4. 接口数据结构

请求参数数据结构

参数名称	参数含义	数据类型	必填	参数说明
appId	客户对接身份ID	String	Y
reqNo	客户请求流水号	String	Y
timestamp	当前请求时间	String	Y	格式：yyyy-MM-dd HH:mm:ss
v	接口版本	String	Y	2.0
body	业务参数	String	Y	json 字符串，根据具体接口规范填写
encKey	加密 key	String	N	使用 rsa 加密的 key 密文
signType	签名方式	String	N	SHA256WithRSA
signValue	签名值	String	Y	参见签名规则

返回参数数据结构

参数名称	参数含义	数据类型	必填	参数说明
body	业务参数	String	N	json 字符串，根据具体接口规范填写
code	返回码	String	Y
msg	返回信息	String	Y
reqNo	客户请求流水号	String	Y	原请求流水号
signType	签名方式	String	N	SHA256WithRSA
signValue	签名值	String	Y	参见签名规则

5. java demo地址

yft-demo-v2.2.zip

说明：点击无法下载时，右键复制链接

签名说明v2（标准对接）

1. 网关地址#

2. 协议规则#

3. 签名规则#

签名验签步骤（body 加密[RAS+AES]）：#

签名加密步骤:#

请求示例#

验签解密步骤：#

4. 接口数据结构#

请求参数数据结构#

返回参数数据结构#

5. java demo地址#