接口调用规则
测试环境请求地址:
普通接口: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中