1 引言

1.1 参数说明

字段	描述
appId	接口请求appId,平台提供的唯一编号
appSecret	与appId配套使用，生成签名
public_key	公钥
private_key	私钥

1.2 环境说明

测试环境接口请求地址：https://getway.upfreework.com/openapi

1.3 接口请求公共参数

所有请求的header报文中都需要有的参数

字段	类型	描述
appId	String	appId
appSign	String	由appId、appSecret、sign、timeStamp字段按照一定的规则拼接后签名生成
timeStamp	String	时间戳，时间精确到毫秒。timestamp 与服务器的时间(北京时间)之间的误差不能超过10分钟。
sign	String	当报文体为空时header不要加此字段或者不设值，不为空时必填，对报文体做MD5摘要后hex（十六进制编码）输出

2 接口开发

2.1 协议规则

要求	说明
传输方式	为保证交易安全性，接口全部采用 HTTPS 传输
提交方式	全部采用POST方式提交
数据格式	提交和返回数据都为JSON格式
字符编码	统一采用 utf-8 字符编码

2.2 签名机制

2.2.1 签名方式

只支持RSA方式签名，签名算法：MD5WithRSA

2.2.2 签名规则

存在请求体时，获取请求完整JSON报文,使用MD5计算出报文摘要值（全小写），再hex输出成字符串sign;

将appId、appSecret、sign、timeStamp参数中非空参数值的参数按照参数名ASCII码从小到大排序（字典序）使用URL键值对的格式（即key1=value1&key2=value2…）拼接成字符串，将该字符串按照指定的签名算法使用交易发送方的签名私钥进行签名，将签名值使用Base64 转码得到签名串appSign。
特别注意以下重要规则：
◆ 参数名ASCII码从小到大排序（字典序）；
◆ 如果参数的值为空不参与签名

将签名值和其他必要字段设置在http header中，注意不要将appSecret加入header中:

HeaderKey	描述
appId	appId
appSign	Base64(RSA(MD5(按照规则拼接成的字符串)))
timeStamp	时间戳
sign	(HEX(MD5(完整JSON报文))

接入指引

1 引言

1.1 参数说明

1.2 环境说明

1.3 接口请求公共参数

2 接口开发

2.1 协议规则

2.2 签名机制

2.2.1 签名方式

2.2.2 签名规则

2.3 代码示例

Java

C#

Python

接入指引

1 引言#

1.1 参数说明#

1.2 环境说明#

1.3 接口请求公共参数#

2 接口开发#

2.1 协议规则#

2.2 签名机制#

2.2.1 签名方式#

2.2.2 签名规则#

2.3 代码示例#

Java#

C##

Python#

1 引言

1.1 参数说明

1.2 环境说明

1.3 接口请求公共参数

2 接口开发

2.1 协议规则

2.2 签名机制

2.2.1 签名方式

2.2.2 签名规则

2.3 代码示例

Java

C#

Python