金数据帮助中心

表单API

金数据个人版表单API用于获取表单结构,目前支持获取表单结构的字段有:

  • 单选框 single_choice
  • 复选框 multiple_choice
  • 下拉框 drop_down
  • 日期 date
  • Email email
  • 数字 number
  • 电话 phone
  • 多行文本 paragraph_text
  • 单行文本 single_line_text

上传文件、商品字段等暂时未支持。

金数据企业版表单API,支持获取包含所有28个字段的表单结构。字段列表如下:

金数据字段 JSON
单行文字,多行文字,姓名,手机,邮箱,电话,表单关联 string
数字,计算字段 Float
单选,下拉框,图片单选 string
多选,图片多选,附件 Array
地址 Object
矩阵单选 Array
矩阵填空,多级下拉框,二级下拉框 Hash
时间 string
网址 String
地址 Object
日期 string
评分 integer
配图商品,无图商品 Array

使用方法

首先确保您有访问API的能力。获得API Key&Secret后,即可获取表单的JSON定义。

例如,通过curl来访问:

curl -u api_key:api_secret https://jinshuju.net/api/v1/forms/ex27t2

请注意,以下JSON内容中,选项类的部分在数据库中以namevalue两部分组成。

您获得的JSON表单定义类似如下:

{
    "name": "意见反馈",
    "description": "<p>当您希望从顾客那里获得反馈时,可以使用该表单收集</p>",
    "fields": [
        {
            "field_9": {
                "label": "您对我们的服务满意么?",
                "type": "single_choice",
                "notes": "",
                "private": false,
                "validation": {},
                "choices": [
                    {
                        "name": "非常满意",
                        "value": "zyRl"
                    },
                    {
                        "name": "满意",
                        "value": "8Q6B"
                    },
                    {
                        "name": "一般",
                        "value": "hPWR"
                    },
                    {
                        "name": "不满意",
                        "value": "s8PE"
                    },
                    {
                        "name": "非常不满意",
                        "value": "fLdR"
                    }
                ],
                "allow_other": false
            }
        },
        {
            "field_10": {
                "label": "您最喜欢的部分是",
                "type": "multiple_choice",
                "notes": "",
                "private": false,
                "validation": {},
                "choices": [
                    {
                        "name": "服务1",
                        "value": "CIoI"
                    },
                    {
                        "name": "服务2",
                        "value": "A8li"
                    },
                    {
                        "name": "服务3",
                        "value": "MIWn"
                    }
                ],
                "allow_other": false
            }
        },
        {
            "field_11": {
                "label": "您希望给我们提出的建议是?",
                "type": "paragraph_text",
                "notes": "",
                "private": false,
                "validation": {}
            }
        },
        {
            "field_8": {
                "label": "希望获得联系",
                "type": "single_line_text",
                "notes": "如果您希望我们联系您,可以留下您的微博、邮箱或者QQ号",
                "private": false,
                "validation": {}
            }
        }
    ]
}
有帮助(23) 未解决问题?联系我们