表单API

金数据表单API用于获取表单结构。

表单API目前支持获取包含以下9个字段的表单结构。字段列表如下：

字段类型	type
单选框	single_choice
复选框	multiple_choice
下拉框	drop_down
日期	date
Email	email
数字	number
电话	phone
地址	address
多行文本	paragraph_text
单行文本	single_line_text

使用方法

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

例如，通过curl来访问：

curl -u apikey:apisecret https://jinshuju.net/api/v1/forms/ex27t2

注意：以下JSON内容中，选项类的部分在数据库中以name和value两部分组成。

您获得的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": {}
            }
        }
    ]
}