收货地址自定义提交

根据用户自定义邮寄地址接收url，把用户收货地址信息发送到用户自有系统，在易企秀测不存储。

对接步骤

url设置：控制台->应用管理->互动编辑器->收货地址自定义提交
当用户中奖填写邮寄地址时会直接转到所配置的接口地址

接口规范

注意：保存的数据会加密，解密方式同事件的一致

保存接口

接收接口：用户自定义的url
请求格式：POST
Content-Type：application/json

接收参数：

{
  "creationId": 10086, //作品id
  "openId": "a7b0f97cf3cc490ba4207e362d625761", //微信授权-微信的openId、手机授权-手机号、自定义授权-userId
  "prizeLevel": "0", //奖品等级
  "prizeLevelName": "一等奖", //奖品等级名称
  "prizeName": "200元优惠券", //奖品名称
  "receiverPhone": "13688410417", //邮寄手机号
  "receiverName": "hgfhfgjghkjl", //邮寄姓名
  "receiverAddress": "kjlkjljkl", //邮寄地址
  "winCode": "24215eY7GS", //中奖码可以和中奖事件唯一关联
}

字段	类型	说明
creationId	Long	作品唯一标识
openId	String	用户唯一标识，微信授权-微信的openId、手机授权-手机号、自定义授权-userId
prizeLevel	String	奖品等级
prizeLevelName	String	奖品等级名称
prizeName	String	奖品名称
receiverPhone	String	邮寄手机号
receiverName	String	邮寄姓名
receiverAddress	String	邮寄地址
winCode	String	中奖码可以和中奖事件唯一关联

返回参数：
正确时返回：

{
"success": true,
"code": "200", //固定值 200代表接口请求成功
"msg": null,
"obj": {
  "thirdId": "b51090fbbf8f4ba89f1027409d4e3f50" //对接测的id
}
}

错误时返回：

{
"success": true,
"code": "200",
"msg": null,
"obj": {
  "errcode": "A0001", //如果保存校验不通过返回errcode、errmsg参数
  "errmsg": "请填写手机号",
}
}

查询接口

由于访客端填写后需要回显地址，需提供查询接口。

接收接口：用户自定义的url
请求格式：POST
Content-Type：application/json

接收参数：

{
  "creationId": 10086, //作品id
  "openId": "a7b0f97cf3cc490ba4207e362d625761", //微信授权-微信的openId、手机授权-手机号、自定义授权-userId
  "winCode": "24215eY7GS", //中奖码可以和中奖事件唯一关联
  "thirdId": "b51090fbbf8f4ba89f1027409d4e3f50"
}

字段	类型	说明
creationId	Long	作品唯一标识
openId	String	用户唯一标识，微信授权-微信的openId、手机授权-手机号、自定义授权-userId
winCode	String	中奖码可以和中奖事件唯一关联
thirdId	String	对接测的唯一标识

返回参数：
正确时返回：

{
"success": true,
"code": "200",
"msg": null,
"obj": {
  "receiverPhone": "13688410417", //邮寄手机号
  "receiverName": "hgfhfgjghkjl", //邮寄姓名
  "receiverAddress": "kjlkjljkl", //邮寄地址
}
}

错误时返回：

{
"success": true,
"code": "200",
"msg": null,
"obj": {}
}