用户工具

站点工具


通用api文档

到此差别页面的链接

后一修订版
前一修订版
通用api文档 [2016/05/17 16:18]
lyy 创建
通用api文档 [2017/06/01 13:59] (当前版本)
行 1: 行 1:
-====== ​商城API文档 ======+====== ​通用API文档 ======
  
 ===== 接口说明 ===== ===== 接口说明 =====
-本文档是拜哥网商城接口。+本文档是拜哥网通用接口。
  
 ===== 安全签名方式 ===== ===== 安全签名方式 =====
 === 1、MD5安全签名机制 === === 1、MD5安全签名机制 ===
-MD5安全签名机制是商户和商城系统约定一个签名key,每次在做签名时将key=value附在待签名字符串后面,然后经MD5加密运算后得到一个签名串,商户和商城系统在检验时也采用同样的方式得到签名串,经比对后确定是否一致,如果一致,则签名通过。目前采用MD5签名+MD5安全签名机制是商户和通用系统约定一个签名key,每次在做签名时将key=value附在待签名字符串后面,然后经MD5加密运算后得到一个签名串,商户和通用系统在检验时也采用同样的方式得到签名串,经比对后确定是否一致,如果一致,则签名通过。目前采用MD5签名
  
 === 2、需要参与签名的参数 === === 2、需要参与签名的参数 ===
-直接把请求数据中的所有元素(除sign和signType)按照“key值=value值”的格式拼接起来,并且把这些拼接以后的元素以“&”字符再连接起来(顺序按首字母升序排列,值为空与签名),如:  +采用MD5加密,加密串格式 “方法名 + + 以&连接的参数连接串 + KEY”,如:  
-access-token=test01&name=test2&sign_type=MD5 +/​article/​getCategoryByAlias&accessId=bf0027585f0226822a21123a1683676f&items={"​identifier":"​help_app"​}iHpDr1411182200 
-这段字符串即是您支付请求时的待签名字符串。  +这段字符串即是您获取分类类别请求时的待签名字符串。  
-如果为MD5加密的则如下:(参数按顺序按首字母升序排列,值为空的不参与签名,MD5的key值放在最后,其他待签名字符串同理可得)+
  
 ===== 接口规范 ​ ===== ===== 接口规范 ​ =====
行 25: 行 25:
  
 ^ 参数 ​             ^ 值                               ^ ^ 参数 ​             ^ 值                               ^
-userToken ​      users                           +accessIdbf0027585f0226822a21123a1683676f
-MD5 签名KEY ​      | test88 ​                         +|access_key ​      |iHpDr1411182200 ​                         | 
-| 数字签名方式signType ​ | MD5  (<wrap em>​不参与数字签名</​wrap>​)  ​+| 接口基本URL ​        | http://vip.8dage.net/api      |
-| 接口基本URL ​        | http://api.shop.my.com/v1/      |+
  
 ===== 接口公共参数 ===== ===== 接口公共参数 =====
行 35: 行 34:
  
 ^ 参数名称 ​      ^ 参数类型 ​   ^ 是否必填 ​ ^ 说明 ​                   ^ ^ 参数名称 ​      ^ 参数类型 ​   ^ 是否必填 ​ ^ 说明 ​                   ^
-userToken  ​| string ​ | 是     | API用户Token            | +accessId| string ​ | 是     | API用户ID            | 
-timestamp  ​| string ​ | 是     ​| ​时间戳 格式YYYYMMDDHHIISS ​ +items| string ​ | 是     ​| ​具体的接口参数JSON串 ​ |
-| signType ​  | string ​ | 是     | 签名类型,目前只支持MD5 ​        |+
 | sign       | string ​ | 是     | 签名 ​                   | | sign       | string ​ | 是     | 签名 ​                   |
  
  
通用api文档.1463473137.txt.gz · 最后更改: 2017/06/01 13:58 (外部编辑)