表单填写结果回调通知

应用场景

当用户在手机端填写完表单并完成提交后,我公司根据在能力使用配置上配置的回调地址,通过POST请求将对应表单的客户填写信息以及用户信息通过接口回调的方式发送给客户,客户需要接收处理,并按文档规范返回应答。

注意:

  • 同样的回调通知可能会多次发送给客户,客户必须能够正确处理重复的通知

  • 后台通知交互时,如果我公司收到客户的应答不符合规范或超时,我公司会判定本次通知失败,会进行重新发送,最多通知3次

通知参数

通知参数说明
  • 通知请求格式为 POST,参数为 json

  • 通知参数格式为 json,key 与表单制作时与各表单项的字段名一致

参数示例如下:
序号 名称 数据类型 描述
1 formId string 表单记录Id
2 formName string 表单名称
3 phone string 填写表单的终端手机号
4 submitTime string 终端填写时间,格式为:yyyy-MM-dd HH:mm:ss
5 formData object 表单填写内容,表单填写内容为json格式
表单填写内容参数示例:

若表单为如下配置:

对应表单填写内容参数示例如下:

{
"phone": "139xxxxxxx"
}

则整体推送内容如下:

{
   "formId ":" 210aadb229464b0381508683d8c1683b",
   "formData": { "phone" : "139xxxxxxx" },
   "formName":"问卷01",
   "phone":"158xxxxxxxx",
   "submitTime":"2021-04-19 15:58:30"
}

返回响应

响应参数说明
序号 名称 数据类型 可选属性 示例值 描述
1 return_code string M SUCCESS SUCCESS/FAIL SUCCESS表示客户接收通知成功 FAIL 表示失败
2 return_msg string O OK 返回信息,如非空,为错误原因
响应示例
{
    "return_code": "SUCCESS",
    "return_msg": "OK"
}
文档更新时间: 2023-04-18 14:24   作者:夏亮