| 后一修订版 | 前一修订版 | ||
|
通用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 | | + | | accessId| bf0027585f0226822a21123a1683676f| |
| - | | 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 | 是 | 签名 | | ||