地址库对接

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

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

![](/media/202302/2023-02-02_152112_0421320.07388328394751953.png)
- 查询地址接口开发规范请参照下文中的《接口开发说明》。
- 如果需要支持用户在选择页面时新增收货地址，请开启新增接口地址，同时填写新增地址页面。
新增地址页面保存新增地址时，使用postMessage，向父页面发送消息通知，父页面根据消息内容业务的定义，就会退回到地址列表页，示例代码：
```js
// 新增地址页面发送消息
window.parent.postMessage({
    eventType: 'saveDeliveryAddress',
	creationType: 'hd' // 编辑器类型 hd:互动
}, '*');
```
- 开启后效果如下：
<img src="/media/202301/2023-01-31_104501_2570770.0885784464288758.png" width="300" style="display: block; transform: translate(150px);">
<img src="/media/202301/2023-01-31_104543_0219610.6580243073516525.png" width="300" style="display: block; transform: translate(150px);">
<img src="/media/202301/2023-01-31_105125_5698490.675944650678128.png" width="300"style="display: block; transform: translate(150px); ">

## 接口开发说明

- 请求方式：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解密后内容如下：
```json
手机授权：
{
  "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 | 地址 |
- 响应示例
```json
{
"success": true,
"code": "200",
"msg": null,
"obj": [{
  "name": "张先生",
  "phone": "18888888888",
  "addr": "成都市高新区天府软件园B区"
}]
}
```