电商平台对接

本文档共分为商户对接及访客端对接两部分。目录如下:

1.商户对接

1.1对接步骤

操作步骤:管理员坐席登陆云客服,点击商户管理

商户管理 —> 一键开户

在开户页面配置商户的一些基本信息

在商户接入设置 —> 查看 获取商户的接入号ID

卡片接口对接

设置地址:系统设置 —> 对接设置 —> 商品信息填写已运行的url地址

示例:

http://140.143.60.140:8223/

接口鉴权:鉴权信息所使用的token和nonce,请在电商版平台端-系统设置-对接设置中获取。

鉴权处理流程:

1)获取请求参数token、timestamp
2)根据token查询nonce值
3)按照token、timestamp、nonce的顺序拼接成字符串,使用sha1算法计算signature值
4)和上送的signature值进行匹配,一致则鉴权成功
5)返回商品信息

请求参数:




字段名 备注
token 系统获取的token
timestamp 时间戳(毫秒)
nonce 系统获取的nonce
commodityId 访客端传的商品id

示例:

http://140.143.60.140:8223/?token=ezYuHCVU6f1KnqWjpN1TGYDztzBXwzNqiXagyvQtszI&timestamp=1586331608718&signature=0a0f24c590e83b330ba6a9b0830baa6f1f6dfb3c&commodityId=12345

请求头:无

请求体:无

接口返回示例:

{
    "data":{
        "price":"¥79.00",
        "imageUrl":"https://img10.360buyimg.com/n6/jfs/t1/88425/40/12091/294889/5e414e07Ecbd6b1b0/712bf44595d18f01.jpg",
        "name":"一次性手套橡胶手套女塑胶男家用纹绣pvc手套透明检查胶皮薄款乳胶胶皮手套丁晴手套 PVC盒装【100只】 均码",
        "desc":""
    }
}

2. 访客端对接

访客端对接需要客户这边自定义一个按钮调用点击方法打开访客端咨询页面

2.1 PC接入

2.1.1 对接点击方法:

注:如果登录平台域名是ecom.7moor.com,则需要把下面的跳转域名改成echat.7moor.com

  function accessDemoFun (data) {
      let popup = window.open('https://yechat.7moor.com/index/' + data.accessId)
      let timer=setTimeout(function () {
          try {
              popup.parent.postMessage({qmInitData: encodeURIComponent(JSON.stringify(data))}, '*')
              clearTimeout(timer);
          } catch(e){
              console.log(e)
          }
      }, 600);
  }

2.1.2 接入参数说明:

data: {
    accessId: '', // 接入号ID (参数类型:字符串,必传)
    userId: '',  // 访客id 自定义用户的唯一id,不能传空字符串、null、中文,id由字母大小写、数字及'-'和 '_'组成(必传)
    sidHeadImg: '', // 访客头像(参数类型:字符串,图片地址)
    nickName: '', // 访客名称(参数类型:字符串)
    venderId: '', // 商铺id (参数类型:字符串,用于展示右侧商铺信息)
    venderName: '', // 商铺名称(参数类型:字符串,用于展示右侧商铺信息)
    venderHeadImg: '', // 商铺头像 (参数类型:字符串,图片地址,用于展示右侧商铺信息)
    commodityId: '', // 正在咨询的商品(参数类型:字符串)
  }

2.1.3 接入示例:

自定义咨询点击按钮,点击执行定义好的accessDemoFun方法
<button onclick="accessDemoFun(data)"></button>

2.2 H5接入

2.2.1 对接点击方法:

function wapAccessDemoFun (data){
     let hrefAddress = 'wap?accessId=' + data.accessId + '&userId=' + data.userId + '&commodityId=' + data.commodityId + '&sidHeadImg=' + data.sidHeadImg + '&nickName=' + data.nickName
window.open('https://yechat.7moor.com/' + hrefAddress)
  }

2.2.2 接入参数说明:

data:{
    accessId: '', // 接入号ID (参数类型:字符串,必传)
    userId: '',  // 访客id 自定义用户的唯一id,不能传空字符串、null、中文,id由字母大小写、数字及'-'和 '_'组成(必传)
    sidHeadImg: '', // 访客头像(参数类型:字符串,图片地址)
    nickName: '', // 访客名称(参数类型:字符串)
    commodityId: '', // 正在咨询的商品(参数类型:字符串)
  }

2.2.3 接入示例:

自定义咨询点击按钮,点击执行定义好的wapAccessDemoFun方法
<button onclick="wapAccessDemoFun(data)"></button>

3. 电商接口

3.1查询商品接口

3.1.1 接口鉴权

注:鉴权信息所使用的token和nonce,请在电商版平台端-系统设置-对接设置中获取。

3.1.2 请求头

3.1.3 请求参数

例如:

http://140.143.60.140:8223/?token=ezYuHCVU6f1KnqWjpN1TGYDztzBXwzNqiXagyvQtszI&timestamp=1586331608718&signature=0a0f24c590e83b330ba6a9b0830baa6f1f6dfb3c&commodityId=12345

字段名 备注
token token
timestamp 时间戳
nonce nonce
commodityId 商品id

3.1.4 请求体

3.1.5 返回体

{
    "data":{
        "price":"¥79.00",
        "imageUrl":"https://img10.360buyimg.com/n6/jfs/t1/88425/40/12091/294889/5e414e07Ecbd6b1b0/712bf44595d18f01.jpg",
        "name":"一次性手套橡胶手套女塑胶男家用纹绣pvc手套透明检查胶皮薄款乳胶胶皮手套丁晴手套 PVC盒装【100只】 均码",
        "desc":""
    }
}

3.1.6 鉴权处理流程

1)获取请求参数token、timestamp 2)根据token查询nonce值 3)按照token、timestamp、nonce的顺序拼接成字符串,使用sha1算法计算signature值 4)和上送的signature值进行匹配,一致则鉴权成功 5)返回商品信息

3.1.7 对接设置

电商版平台端-系统设置-对接设置中填写已运行的url地址即可。 例如:

http://140.143.60.140:8223/

3.2 店铺信息接口

3.2.1 接口鉴权

注:鉴权信息所使用的token和nonce,请在电商版平台端-系统设置-对接设置中获取。

3.2.2 请求头

3.2.3 请求参数

例如:

http://140.143.60.140:8223/?token=ezYuHCVU6f1KnqWjpN1TGYDztzBXwzNqiXagyvQtszI&timestamp=1586331608718&signature=0a0f24c590e83b330ba6a9b0830baa6f1f6dfb3c&orderId=12345

字段名 备注
token token
timestamp 时间戳
nonce nonce
orderId 订单id

3.2.4 请求体

3.2.5 返回体

{
    "data":[
        {
            "orderNum":"107576153756",
            "price":"¥17,999",
            "status":"已发货",
            "date":"19-12-12 11:52:36",
            "list":[
                {
                    "price":"¥8,999",
                    "imageUrl":"https://img10.360buyimg.com/n6/jfs/t1/88425/40/12091/294889/5e414e07Ecbd6b1b0/712bf44595d18f01.jpg",
                    "name":"海信(Hisense)HZ55E5D 55英寸 AI声控 MEMC防抖 超薄全面屏 4K超高清 人工智能A...",
                    "desc":"海信(Hisense)HZ55E5D 55英寸 AI声控 MEMC防抖 超薄全面屏 4K超高清 人工智能A..."
                },
                {
                    "price":"¥8,999",
                    "imageUrl":"https://img10.360buyimg.com/n6/jfs/t1/88425/40/12091/294889/5e414e07Ecbd6b1b0/712bf44595d18f01.jpg",
                    "name":"海信(Hisense)HZ55E5D 55英寸 AI声控 MEMC防抖 超薄全面屏 4K超高清 人工智能A...",
                    "desc":"海信(Hisense)HZ55E5D 55英寸 AI声控 MEMC防抖 超薄全面屏 4K超高清 人工智能A..."
                }
            ]
        }
    ]
}

3.2.6 鉴权处理流程

1)获取请求参数token、timestamp 2)根据token查询nonce值 3)按照token、timestamp、nonce的顺序拼接成字符串,使用sha1算法计算signature值 4)和上送的signature值进行匹配,一致则鉴权成功 5)返回商品信息

3.2.7 对接设置

电商版平台端-系统设置-对接设置中填写已运行的url地址即可。 例如:

http://140.143.60.140:8223/

3.3 订单信息接口

3.3.1 接口鉴权

注:鉴权信息所使用的token和nonce,请在电商版平台端-系统设置-对接设置中获取。

3.3.2 请求头

3.3.3 请求参数

例如:

http://140.143.60.140:8223/?token=ezYuHCVU6f1KnqWjpN1TGYDztzBXwzNqiXagyvQtszI&timestamp=1586331608718&signature=0a0f24c590e83b330ba6a9b0830baa6f1f6dfb3c&storeId=12345

字段名 备注
token token
timestamp 时间戳
nonce nonce
storeId 店铺id

3.3.4 请求体

3.3.5 返回体

{
    "data":{
        "img":"https://img10.360buyimg.com/n6/jfs/t1/88425/40/12091/294889/5e414e07Ecbd6b1b0/712bf44595d18f01.jpg",
        "tradeType":"电商行业",
        "grade":"27",
        "userGrade":"9.0",
        "logisticsGrade":"9.0",
        "serviceGrade":"9.0"
    }
}

3.3.6 鉴权处理流程

1)获取请求参数token、timestamp 2)根据token查询nonce值 3)按照token、timestamp、nonce的顺序拼接成字符串,使用sha1算法计算signature值 4)和上送的signature值进行匹配,一致则鉴权成功 5)返回商品信息

3.3.7 对接设置

电商版平台端-系统设置-对接设置中填写已运行的url地址即可。 例如:

http://140.143.60.140:8223/