奇门自定义API对接说明

对接奇门自定义API和对接旺店通标准API,能够实现的功能相同。
区别在于是与奇门云官网对接还是与旺店通开放平台对接。

1. 申请奇门授权的appkey

前置要求:企业级支付宝账号。
第一步:注册淘宝开放平台开发者。(已注册客户跳过)
http://open.taobao.com/docs/doc.htm?spm=a219a.7386781.3.2.TEOEeU&docType=1&articleId=103232&treeId=49#
打开连接->右上角选择登录。

登录淘宝账号

第二步:使用下方链接注册奇门应用。
http://my.open.taobao.com/common/applyIsv.htm?appTag=133&accessCode=96A11209D311D275DA05937EAFFEDAC1
前置条件:企业资质的支付宝账号。

后续就是创建应用,然后等待小二申请。
2. 授权通过够,私聊将appkey提供给旺店通的技术人员(http://doc.wangdian.cn/?p=859&preview=true “奇门云网官对接说明”)
3. 根据奇门云网官对接说明文档,进行请求方式的改造。奇门请求需要设置白名单。如图,将ip地址加入白名单后才可以请求奇门。

4. 与旺店通联调。

2.对接方式描述:

为了完善和规范对接业务,api接口已经陆续的完成接口改造。具体完成情况,请看API说明的奇门自定义接口列表。
奇门角色介绍:奇门只是一个数据传输的通道,卖家只需要与奇门对接,将请求发送给奇门。奇门通过卖家请求参数中的目标appkey:target_app_key来锁定卖家目标请求的是旺店通,因此请求到旺店通接口。旺店通在通过奇门将数据返回给卖家。

3.数据传输描述:

4.奇门角色描述:

针对原始形式的接口,如果客户需要对接三个系统,那么需要开发三套对接逻辑。改造成奇门接口之后,只要开发一套对接奇门的逻辑,改变参数target_app_key就可以对接任意系统。(前提是,该系统支持奇门对接)

对于已经对接过api标准接口的客户来说,需要以下几步调整(新客户直接参考下面的对接说明即可):

1.  申请奇门授权的appkey和秘钥,并且提供appkey给旺店通技术人员。(申请流程见http://doc.wangdian.cn/2017/12/10/%e5%a5%87%e9%97%a8%e4%ba%91%e7%bd%91%e5%ae%98%e6%94%b9%e9%80%a0%e6%b5%81%e7%a8%8b/)
2.  在原来的请求参数基础上对应加上奇门的系统参数即可。(具体见下面的对接说明描述)
3.  奇门自定义采用统一入口形式,也就是说不同的接口请求的地址是相同的,而不同的接口是通过系统参数中的method来区分。(由于奇门接口有一定的命名规则,所以接口名称有对应的调整。比如,之前查询订单管理接口trade_query.php现在改为:method=wdt.trade.query,其他接口也做了相似的调整,具体可以查看对应的在线文档)
4.  签名的计算方式采用奇门的计算方式。请求方式依然是post请求。
5.  返回值中的错误码为了避免与奇门返回值冲突,将code改为errorcode。

4.对接说明

奇门对接说明文档地址:http://open.taobao.com/docs/doc.htm?spm=a219a.7395905.0.0.vrJf9P&articleId=101617&docType=1&treeId=1

(1)条件:经过奇门授权分配的appkey,secretKey
(2)请求参数:

奇门系统参数:

'method'=>'wdt.trade.query'     //方法名即接口名,格式为wdt.原接口名称('-'变成‘.’)例如:查询订单管理原来的名字为trade_query.php,现在改为wdt.trade.query
'app_key'=>'******' //奇门授权app_key(向奇门申请获得)
'target_app_key'=>'21363512'  //目标app_key,固定为21363512
'format'=>'json' //请求数据格式,固定为json
'sign_method'=>'md5' //对接奇门sign计算方式,固定为md5
'secretKey'=>'***********************' //奇门授权秘钥(向奇门申请获得)

旺店通系统参数:

'sid'=>'apidev2'  //卖家账号
'timestamp'=>date('Y-m-d H:i:s',time()) //时间戳
'sign'=>’****************’//计算方式如下

旺店通业务参数:(按照文档填写即可)

 'end_time'=>'2017-10-27 02:11:45',
 'start_time'=>'2017-10-27 02:11:00',
 'status'=>0,
 'page_no'=>0,
 'page_size'=>10,

(3)sign计算方式

** demo数据:**

$data=array(
       //奇门系统参数
    'method'=>'wdt.trade.query',
    'app_key'=>'*******', 
    'target_app_key'=>'21363512', 
    'format'=>'json',
    'sign_method'=>'md5',
    'secretKey'=>'ff34***************585a3',
      //接口系统参数
    'sid'=>'apidev2',
    'timestamp'=>date('Y-m-d H:i:s',time()),
      //订单查询接口业务数据
     'end_time'=>'2017-10-27 02:11:45',
     'start_time'=>'2017-10-27 02:11:00',
     'status'=>0,
     'page_no'=>0,
     'page_size'=>10,
     'trade_no'=>'JY201710270002',
);

1)对数组升序排序,结果如下:

$data=array(
  'app_key'=>'28*****',
  'end_time'=>'2017-10-27 02:11:45',
  'format'=>'json',
  'method'=>'wdt.trade.query', 
  'page_no'=>0,
  'page_size'=>10,
  'secretKey'=>'ff34**************2585a3',
  'sid'=>'apidev2',
  'sign_method'=>'md5',
  'start_time'=>'2017-10-27 02:11:00',
  'status'=>0,
  'target_app_key'=>'21363512', 
  'timestamp'=>date('Y-m-d H:i:s',time()),
  'trade_no'=>'JY201710270002',
 );

2)secretKey+’keyvalue’+secretKey, 结果如下:

ff34**************2585a3app_key23305776end_time2017-10-27 02:11:45formatjsonmethodwdt.trade.querypage_no0page_size10secretKeyff34**************2585sidapidev2sign_methodmd5start_time2017-10-27 02:11:00status0target_app_key21363512timestamp2017-11-19 19:55:42trade_noJY201710270002ff34**************2585

** 3)大写md5加密,结果如下:**

md5(secretKey+’keyvalue’+secretKey)
A88C125F415F1D02DA94F3B29AB06FF1

(4)请求奇门地址:(所有接口请求同一地址,根据参数中的method来区分接口)

测试环境地址:http://hu3cgwt0tc.api.taobao.com/router/qmtest
正式环境地址:http://hu3cgwt0tc.api.taobao.com/router/qm

Print Friendly, PDF & Email