地址库对接


支持访客在中奖后,填写收货地址时可直接选择通过接口对接的地址库信息。方便用户高效填写收货地址,同时也能避免填写地址出错。

  1. 在ECMP后台,控制台->应用管理->互动编辑器->地址库对接,设置对接的地址接口和新增地址页面。

  • 查询地址接口开发规范请参照下文中的《接口开发说明》。
  • 如果需要支持用户在选择页面时新增收货地址,请开启新增接口地址,同时填写新增地址页面。
    新增地址页面保存新增地址时,使用postMessage,向父页面发送消息通知,父页面根据消息内容业务的定义,就会退回到地址列表页,示例代码:
    // 新增地址页面发送消息
    window.parent.postMessage({
      eventType: 'saveDeliveryAddress',
      creationType: 'hd' // 编辑器类型 hd:互动
    }, '*');
    
  • 开启后效果如下:

接口开发说明

  • 请求方式:POST

  • Content-Type:application/json

  • 请求参数

    参数名 是否必须 参数类型 参数说明
    timestamp 必须 String 请求时的时间戳
    nonce 必须 String 随机字符串
    signature 必须 String 请求签名
    msgEncrypt 必须 String 加密后的消息
  • msgEncrypt内容如下:

    参数名 是否必须 参数类型 参数说明
    creationId 必须 Int 活动id
    mobile String 手机号(参与类型为手机用户授权时)
    openId String 微信openId(参与类型为微信授权时)
    userId String 用户Id(参与类型为自定义授权时)
  • msgEncrypt解密后内容如下:

    手机授权:
    {
    "creationId":10086,
    "mobile":"183********" // 明文
    }
    微信授权:
    {
    "creationId":10086,
    "openId":"微信openid",
    }
    自定义用户:
    {
    "creationId":10086,
    "userId":"userId"// 对接方提供的用户唯一标识
    }
    
  • 接口返回值

    参数名 是否必须 类型 备注
    code String 200-成功
    msg String 错误信息
    obj List 收货地址的数据
    obj.name String 姓名
    obj.phone String 电话
    obj.addr String 地址
  • 响应示例

    {
    "success": true,
    "code": "200",
    "msg": null,
    "obj": [{
    "name": "张先生",
    "phone": "18888888888",
    "addr": "成都市高新区天府软件园B区"
    }]
    }
    

2024年11月25日 16:25 3609 收藏文档