新增多条唯一数据

• 描述
• 使用须知
• 接口URL
• 名词解释
• 请求参数
• 请求示例
• 响应参数
• 响应数据样例

描述

根据指定的字段在指定表单新增多条数据，当指定字段的值已经存在的时候，不进行新增，并返回已经存在的数据的ID

使用须知

开发前，请仔细阅读开发指南。

• POST请求头

{"Authorization": "Bearer YOUR_APIKEY"}

• YOUR_APIKEY请阅读开发指南了解。

接口URL

POST - /openapi/v1/app/{app_id}/entry/{entry_id}/batch_unique_create

名词解释

名称	说明
app_id	应用ID
entry_id	该应用内的表单ID

app_id+entry_id表示全局唯一的表单标识，前往开发平台中的API文档进行查看。

请求参数

参数名	示例值	参数类型	是否必填	参数描述
datas		Object	是	多条数据内容
is_start_workflow	false	Boolean	否	用来控制是否触发流程，默认不触发流程
is_start_event	true	Boolean	否	是否触发事件（模块事件/_form事件/数据助手）
operator	5466ebe918a90c64c26fcc67	String	否	操作人id，默认使用应用所有者的id
unique	单行文本	Array	是	唯一字段，可以是多个字段 必须是以下类型控件：单行文本、多行文本，数字，日期, 下拉框，成员单选，部门单选，单选按钮组

请求示例

{
    "datas": [
        {
            "单行文本": "张三",
            "多行文本": "webapi",
            "数字": 8,
            "日期时间": "2019-01-01 11:11:11",
            "单选按钮组": "一年级",
            "复选框组": [
                "选项1",
                "选项2"
            ],
            "下拉框": "女",
            "下拉复选框": [
                "选项1",
                "选项2"
            ],
            "地址": {
                "province": "湖南省",
                "city": "长沙市",
                "district": "芙蓉区",
                "detail": "韶山北路"
            },
            "定位": {
                "province": "湖南省",
                "city": "长沙市",
                "district": "芙蓉区",
                "detail": "韶山北路",
                "lnglatXY": [
                    112.99627,
                    28.19393
                ]
            },
            "图片": [
                {
                    "name": "123.jpg",
                    "url": "https://qiniu.XXX.com/FvNMG4BF9LEsbSv3HaO5gA9U0rQz"
                }
            ],
            "子表单": [
                {
                    "单行文本_子表单": "张三"
                },
                {
                    "单行文本_子表单": "张三"
                }
            ],
            "成员单选": "5577ebc4504e8e77036d2a09",
            "成员多选": [
                "5577ebc4504e8e77036d2a09"
            ],
            "部门单选": "51d1177b964603db9e60a962",
            "部门多选": [
                "51d1177b964603db9e60a962"
            ]
        }
    ],
    "is_start_workflow": false,
    "is_start_event": true,
    "operator": "5466ebe918a90c64c26fcc67",
    "unique": [
        "单行文本"
    ]
}

响应参数

参数名	示例值	参数类型	参数描述
data	-	Array	返回数据内容
data.status	0	Number	状态 0失败，1成功
data.data_id	5429f2cdd0c1fa984e1fe6d8	Array	成功时返回成功数据的id，失败时返回已存在数据的id
data.error_code	11003	Number	错误码，成功时 0
data.error_message	唯一字段对应数据已存在	String	错误详情，成功时ok

响应数据样例

{
    "data": [
        {
            "status": 1,
            "data_id": [
                "5429f2cdd0c1fa984e1fe6d8"
            ],
            "error_code": 0,
            "error_message": "ok"
        },
        {
            "status": 1,
            "data_id": [
                "55e74350506aa92130a85289"
            ],
            "error_code": 0,
            "error_message": "ok"
        }
    ]
}