接口调用规则

测试环境请求地址:

普通接口: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/json

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

        (拼接链接顺序要与sign加密顺序保持一致,否则签名无效)

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


聚水潭官网 | 百科 | 开放平台

版权所有© 2016 上海聚水潭网络科技有限公司 沪ICP备14047939号-1 Copyright © 2016 JUSHUITAN Network Technology CO.,LTD. All Rights Reserved.