接口调用规则

测试环境请求地址:

普通接口:https://c.jushuitan.com/api/open/query.aspx

正式环境请求地址:

普通接口:https://open.erp321.com/api/open/query.aspx

参数说明:以下为系统参数

partnerid          合作方编号，用于接口的加密由我方提供

partnerkey       接入密钥，用于接口的加密由我方提供

token                授权码，用于接口的加密由我方提供

ts                      当前请求时间，时间戳格式(Unix 纪元到当前时间的秒数，10位)

method            调用具体接口的参数名，由我方给定

sign                  签名参数，按一定规则进行MD5  32位小写加密后的字符串

普通接口调用规则:

1、使用HTTP协议发送POST请求调用接口

2、HTTP请求头类型：Content-Type: application/x-www-form-urlencoded

3、系统参数跟随url

4、业务参数以json的格式放入http-body中

请求链接示例说明:(以测试环境调用店铺查询接口为例)

1、获取调用接口的接口名称以及系统参数

method：     shops.query

partnerid：   ywv5jGT8ge6Pvlq3FZSPol345asd

token：        181ee8952a88f5a57db52587472c3798

2、根据当前时间获取时间戳 (Unix 纪元到当前时间的秒数，10位)

ts：              1608000837

3、以及根据sign计算规则组成源串并进行MD5 32位小写加密

3.1、sign的组成方式:

3.1.1、token和ts为key、value键值对

3.1.2、key,value  为传入的系统参数，按url中的传递顺序(加密 key 中排除sign，method，partnerid，partnerkey)

3.1.3、组成加密源串：

规则：method +partnerid + (key1+value1+key2+value2) +partnerkey

例：shops.queryywv5jGT8ge6Pvlq3FZSPol345asdtoken181ee8952a88f5a57db52587472c3798ts1608000837

ywv5jGT8ge6Pvlq3FZSPol2323

3.2、MD5 32位小写加密

sign：MD5(method +partnerid + (key1+value1+key2+value2) +partnerkey)；

加密结果：sign=403697654caffbbfe21a841782b6af8f

4、根据系统参数以及sign进行拼接链接

https://c.jushuitan.com/api/open/query.aspx?method=shops.query&partnerid=ywv5jGT8ge6Pvlq3FZSPol345asd&token=181ee8952a88f5a57db52587472c3798&ts=1608000837&

sign=403697654caffbbfe21a841782b6af8f

注:请求的业务参数以json格式放入http-body中