金数据帮助中心

数据推送API

开启数据推送

如果您想将某个表单新提交的数据推送到指定URL,您可以在表单的 设置 —— 数据提交 页面的底部找到将 数据以JSON格式发送给第三方,勾选开启后您将看到当前表单的字段对照表。 填写地址并保存后,金数据会在表单收到新数据后向指定的地址以JSON格式POST该数据。

数据推送示例

例如指定URL为http://url.com/jinshuju/callback,则金数据以JSON格式POST该数据的Entry信息。

发送的JSON数据以字段的key来展示,字段对照表将列出Key与Label的对应关系。

POST http://url.com/jinshuju/callback
Content-Type: application/json
X-Requested-By: jinshuju
{
    "form": "xJfeTv",
    "entry": {
        "field1": 123,
        "field2": "Hello, World",
        "field3": "It's very good."
    }
}

字段的对应格式

金数据字段 JSON 样例
单行文字,多行文字,姓名,手机,邮箱,电话,表单关联 string "你好,世界"
数字,计算字段 Float 123.4
单选,下拉框,图片单选 string "男"
多选,图片多选,附件 Array ["篮球","足球"]
地址 Object {"province":"陕西", "city":"西安", "address":"锦业一路软件园"}
矩阵单选 Array {"statement"=>"题目1", "choice"=>"选项1"}, {"statement"=>"题目2", "choice"=>"选项2"}, {"statement"=>"题目3", "choice"=>"选项3"}
矩阵填空,多级下拉框,二级下拉框 Hash {"statement"=>"题目1", "dimensions"=>{"项目1"=>"1", "项目2"=>"2", "项目3"=>"3"}}, {"statement"=>"题目2", "dimensions"=>{"项目1"=>"11", "项目2"=>"22", "项目3"=>"33"}}, {"statement"=>"题目3", "dimensions"=>{"项目1"=>"111", "项目2"=>"222", "项目3"=>"333"}}
时间 string "00:00"
网址 String "http://jinshuju.com"
地址 Object {"province":"陕西", "city":"西安", "address":"锦业一路软件园"}
日期 string "2012-04-16"
评分 integer 13
配图商品,无图商品 Array {"name"=>"商品一", "number"=>1}, {"name"=>"商品二", "number"=>2}

注意事项

  • 对方服务器需在2秒内返回200作为应答,2秒后金数据将中断连接。
  • 如果出错,金数据会最多重试6次。
  • 如果连续重试6次均失败,该表单的数据推送过程将停止,表单创建者将获得邮件通知。开发者需要在数据推送设置中手工启动,只有成功,数据推送才会继续。
  • 多级下拉框字段只在金数据企业版中支持,二级下拉框字段在金数据个人版中支持。
  • 计算字段字段只在金数据企业版中支持,金数据个人版中不支持。
有帮助(26) 未解决问题?联系我们