自定义表单提交

> 根据用户自定义表单接收url，把表单数据发送到用户自有系统

# 对接步骤

1. url设置：控制台->集成管理->表单自定义提交
2. 创建表单作品，
3. 用户使用表单作品提交表单
4. 配置的url将接收到表单提交数据

# 接口规范
- 接收接口：用户自定义的url
- 请求格式：POST
- Content-Type：application/json
- 接收参数：
```json
{
  "currentUrl": "https://lxx.eqxiu.cn/v/522703?cc=o1y3SPPn&code=qjzq91",
  "data": {
    "1241866826": "选项1"
  },
  "corpId": "f610ed30b0e348049b0f37eab83d821b",
  "dataInfo": {
    "dataId": 38772321,
    "star": 0,
    "costTime": 3301,
    "sourceType": false,
    "delFlag": false,
    "status": 0
  },
  "di": "06537f15-abe3-4c11-ad65-3e6c3337b3fa",
  "customerInfo": {
    "openId": "",
    "nickName": "brhnygt",
    "sex": 1,
    "headImgUrl": "https://asset.eqxiu.cn/common/icon-custom-set.png",
    "unionId": "",
    "encodeId": "bcab643809104339ac87fc3558b4cc33",
    "thirdUserId": "o166r7f3ry0bmpqe4207wqaogbrhnygt",
    "mobile": "13647924637",
    "corpId": "f610ed30b0e348049b0f37eab83d821b",
    "type": 3,
    "channelKey": "mo",
    "msg1": "y2FGVYZa1O4U",
    "msg2": "p7rBAP39XN8A",
    "msg4": "gYmjsTh7oKMc",
    "state": "扩展字段",
    "registerTime": "1783414409763"
  },
  "customInfo": {
    "openId": "",
    "nickName": "brhnygt",
    "sex": 1,
    "headImgUrl": "https://asset.eqxiu.cn/common/icon-custom-set.png",
    "unionId": "",
    "encodeId": "bcab643809104339ac87fc3558b4cc33",
    "thirdUserId": "o166r7f3ry0bmpqe4207wqaogbrhnygt",
    "mobile": "13647924637",
    "corpId": "f610ed30b0e348049b0f37eab83d821b",
    "type": 3,
    "channelKey": "mo",
    "msg1": "y2FGVYZa1O4U",
    "msg2": "p7rBAP39XN8A",
    "msg4": "gYmjsTh7oKMc",
    "state": "扩展字段",
    "registerTime": "1783414409763"
  },
  "ua": {
    "os": "OSX 10_15_7",
    "ip": "117.175.146.35",
    "browser": "Chrome 149.0.0.0",
    "region": {
      "country": "中国",
      "province": "四川",
      "city": "成都",
      "district": "-"
    },
    "ua": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/149.0.0.0 Safari/537.36",
    "device": "Mac"
  },
  "title": "调研问卷",
  "type": "form",
  "totalScore": "-1",
  "formMeta": {
    "1241866826": {
      "score": "{\"score\":10,\"showScoreAndAnswer\":false,\"answers\":[],\"answerKeys\":\"\",\"scoreMethodType\":2,\"list\":[{\"score\":10,\"default\":false,\"maxLimit\":999,\"id\":1,\"label\":\"选项1\",\"tag\":\"custom\"},{\"score\":10,\"default\":false,\"maxLimit\":999,\"id\":2,\"label\":\"选项2\",\"tag\":\"custom\"},{\"score\":10,\"default\":false,\"maxLimit\":999,\"id\":3,\"label\":\"选项3\",\"tag\":\"custom\"}]}",
      "num": 1,
      "type": "scoreRadio",
      "title": "单选题",
      "delFlag": false
    }
  },
  "distributeId": "other",
  "formDataId": 38772321,
  "id": 522703
}
```
| 字段 | 类型 | 说明 |
| --- | --- | --- |
| id | Long | 作品唯一标识 |
| corpId | Long | 企业id |
| title | String | 内容标题 |
| currentUrl | String | 表单提交时，浏览器地址信息，后端提交时携带 |
| type | String | 作品类型 h5：h5作品 lc:长页面 form:表单 |
| formDataId | Long | 表单提交数据的唯一Id，后端提交时会携带该参数 |
| formMeta.{elementId}.type | String | 表头类型 |
| formMeta.{elementId}.title | String | 表头名称 |
| formMeta.{elementId}.status | Integer | 表头状态 |
| formMeta.{elementId}.delFlag | Boolean | 表头是否删除（true：已删除 false:未删除） |
| formMeta.{elementId}.options | List | 选项（根据type不同，返回值有所区别，[见详细说明](https://eqxiu.yuque.com/books/share/44b14721-3832-43c7-96e4-c48d035c305e/lgv8fd#ElYNH)） |
| formMeta.{elementId}.score | String | 计分组件选项信息（json字符串，根据type不同，返回值有所区别，[见详细说明](https://eqxiu.yuque.com/books/share/44b14721-3832-43c7-96e4-c48d035c305e/lgv8fd#ElYNH)） |
| ua.ua | String	 | 浏览器请求原始user-agent 后端提交时携带|
| ua.os | String | 设备系统信息 后端提交时携带|
| ua.device | String | 设备信息 后端提交时携带|
| ua.browser | String | 浏览器信息 后端提交时携带|
| ua.ip | String | ip地址 后端提交时携带|
| dataInfo.status | Integer | 数据状态 |
| dataInfo.costTime | Long | 表单提交耗时 |
| dataInfo.star | Integer | 星级 |
| dataInfo.delFlag | Boolean | 该表单数据是否删除（true：已删除 false:未删除） |
| data.{elementId} | String | 表单值（elementId：对应表头formMeta.elementId） |
| customerInfo.encodeId | Srtring | 用户唯一标识【易企秀】 |
| customerInfo.type | int  | 授权用户类型，1微信，2手机，3自定义 |
| customerInfo.corpId | String | 企业唯一标识 |
| customerInfo.nickName | String | 微信昵称，userType为1时 |
| customerInfo.mobile | String | 手机号，userType为2时 |
| customerInfo.sex | String | 微信性别，userType为1时 |
| customerInfo.language | String | 微信信息，userType为1时 |
| customerInfo.city | Integer | 微信信息，userType为1时 |
| customerInfo.country | String | 微信信息，userType为1时 |
| customerInfo.headImgUrl | String | 微信信息，userType为1时 |
| customerInfo.unionId | String | 微信信息，unionId |
| customerInfo.appIdType | Integer | appId类型，1、易企秀 ；非 1，非易企秀 |
| customerInfo.thirdAppId | String | 微信信息,appId |
| customerInfo.thirdOpenId | String | 微信信息，openId |

- 返回参数：
正确时返回：
```json
{
  "success": true,
  "code": "200", //固定值 200代表接口请求成功
  "msg": null,
  "obj": {
    "thirdId": "b51090fbbf8f4ba89f1027409d4e3f50" //对接测的id
  },
}
```
错误时返回：
```json
{
  "success": true,
  "code": "200",
  "msg": null,
  "obj": {
    "errcode": "A0001", //如果保存校验不通过返回errcode、errmsg参数
    "errmsg": "请填写手机号",
  },
}
```

- 接口要求
-- 参数说明
    部分参数是区分前后端保存，像currentUrl，uajson对象等浏览器设备信息是后端保存填充，前端提交时，没有对应的字段
-- 前端保存
需支持跨域访问（因为数据不经过易企秀后台，由前端直接传输，会有跨域问题）
demo：
![](/media/202205/2022-05-27_114818_431554.png)
-- 后端保存
后端保存的数据会加密，解密方式同事件的一致