新建多条数据接口

创建多条数据接口最多支持 100 条数据。

请求地址：https://api.jiandaoyun.com/api/v5/app/entry/data/batch_create

**请求频率：**10 次/秒

请求方式：POST

请求参数：

参数	类型	必需	说明	默认
app_id	String	是	应用ID	——
entry_id	String	是	表单ID
data_list	Array	是	数据内容数组
data_creator	String	否	数据提交人（取成员编号 username，可从通讯录接口获取）	企业创建者
transaction_id	String	否	事务ID；transaction_id 用于表示一次事务，用于防止因重试而导致重复创建同一批数据，也用于绑定一批文件，建议使用 UUID 以免重复。
is_start_workflow	Bool	否	是否发起流程（仅流程表单有效）	false

请求示例：

{
  "app_id": "59264073a2a60c0c08e20bfb",
  "entry_id": "59264073a2a60c0c08e20bfd",
  "transaction_id": "87cd7d71-c6df-4281-9927-469094395677",   //事务ID
    "data_list": [
        {
            "_widget_1432728651402": { // 单行文本
                "value": "简道云1"
            },
            "_widget_1432728651403": { // 数字
                "value": 100
            },
            "_widget_1528854613291": { // 子表单
                "value": [
                    { // 子表单子记录结构跟主表一致
                        "_widget_1528854614409": {
                            "value": "子表单数据11"
                        },
                        "_widget_1528854615499": {
                            "value": 1001
                        }
                    },
                    {
                        "_widget_1528854614410": {
                            "value": "子表单数据12"
                        },
                        "_widget_1528854615419": {
                            "value": 1002
                        }
                    }
                ]
            }
        }, 
        {
            "_widget_1432728651402": {
                "value": "简道云2"
            },
            "_widget_1432728651403": {
                "value": 200
            },
            "_widget_1528854613291": {
                "value": [
                    {
                        "_widget_1528854614409": {
                            "value": "子表单数据21"
                        },
                        "_widget_1528854615499": {
                            "value": 2001
                        }
                    }
                ]
            }
        },
        {
            "_widget_1432728651402": {
                "value": "简道云3"
            },
            "_widget_1432728651403": {
                "value": 300
            },
            "_widget_1528854613291": {
                "value": [
                    {
                        "_widget_1528854614410": {
                            "value": "子表单数据31"
                        },
                        "_widget_1528854615419": {
                            "value": 3001
                        }
                    }
                ]
            }
        }
    ],
    "is_start_workflow": true
}

响应内容：

参数	类型	说明
status	String	返回请求结果
success_count	Number	创建成功的数据条数
success_ids	Array	创建成功的数据的ID列表

响应示例：

{
    "status": "success",
    "success_count": 3,
    "success_ids": [
        "200001181fe09728936510eb",
        "200001181fe09728936510ec",
        "200001181fe09728936510ed"
    ]
}

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json

app_id

string

应用ID

必需

entry_id

string

表单ID

必需

data_list

array [object]

数据内容数组

必需

transaction_id

string

可选

事务ID；transaction_id 用于表示一次事务，用于防止因重试而导致重复创建同一批数据，也用于绑定一批文件，建议使用 UUID 以免重复。

is_start_workflow

boolean

可选

是否发起流程（仅流程表单有效）

默认值:

false

data_creator

string | null

可选

数据提交人（取成员编号 username，可从通讯录接口获取

示例

{
    "app_id": "59264073a2a60c0c08e20bfb",
    "entry_id": "59264073a2a60c0c08e20bfd",
    "transaction_id": "87cd7d71-c6df-4281-9927-469094395677", //事务ID
    "data_list": [
        {
            "_widget_1432728651402": { // 单行文本
                "value": "简道云1"
            },
            "_widget_1432728651403": { // 数字
                "value": 100
            },
            "_widget_1528854613291": { // 子表单
                "value": [
                    { // 子表单子记录结构跟主表一致
                        "_widget_1528854614409": {
                            "value": "子表单数据11"
                        },
                        "_widget_1528854615499": {
                            "value": 1001
                        }
                    },
                    {
                        "_widget_1528854614410": {
                            "value": "子表单数据12"
                        },
                        "_widget_1528854615419": {
                            "value": 1002
                        }
                    }
                ]
            }
        },
        {
            "_widget_1432728651402": {
                "value": "简道云2"
            },
            "_widget_1432728651403": {
                "value": 200
            },
            "_widget_1528854613291": {
                "value": [
                    {
                        "_widget_1528854614409": {
                            "value": "子表单数据21"
                        },
                        "_widget_1528854615499": {
                            "value": 2001
                        }
                    }
                ]
            }
        },
        {
            "_widget_1432728651402": {
                "value": "简道云3"
            },
            "_widget_1432728651403": {
                "value": 300
            },
            "_widget_1528854613291": {
                "value": [
                    {
                        "_widget_1528854614410": {
                            "value": "子表单数据31"
                        },
                        "_widget_1528854615419": {
                            "value": 3001
                        }
                    }
                ]
            }
        }
    ],
    "is_start_workflow": true
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.jiandaoyun.com/api/v5/app/entry/data/batch_create' \
--header 'Content-Type: application/json' \
--data-raw '{
    "app_id": "59264073a2a60c0c08e20bfb",
    "entry_id": "59264073a2a60c0c08e20bfd",
    "transaction_id": "87cd7d71-c6df-4281-9927-469094395677", //事务ID
    "data_list": [
        {
            "_widget_1432728651402": { // 单行文本
                "value": "简道云1"
            },
            "_widget_1432728651403": { // 数字
                "value": 100
            },
            "_widget_1528854613291": { // 子表单
                "value": [
                    { // 子表单子记录结构跟主表一致
                        "_widget_1528854614409": {
                            "value": "子表单数据11"
                        },
                        "_widget_1528854615499": {
                            "value": 1001
                        }
                    },
                    {
                        "_widget_1528854614410": {
                            "value": "子表单数据12"
                        },
                        "_widget_1528854615419": {
                            "value": 1002
                        }
                    }
                ]
            }
        },
        {
            "_widget_1432728651402": {
                "value": "简道云2"
            },
            "_widget_1432728651403": {
                "value": 200
            },
            "_widget_1528854613291": {
                "value": [
                    {
                        "_widget_1528854614409": {
                            "value": "子表单数据21"
                        },
                        "_widget_1528854615499": {
                            "value": 2001
                        }
                    }
                ]
            }
        },
        {
            "_widget_1432728651402": {
                "value": "简道云3"
            },
            "_widget_1432728651403": {
                "value": 300
            },
            "_widget_1528854613291": {
                "value": [
                    {
                        "_widget_1528854614410": {
                            "value": "子表单数据31"
                        },
                        "_widget_1528854615419": {
                            "value": 3001
                        }
                    }
                ]
            }
        }
    ],
    "is_start_workflow": true
}'

新建多条数据接口

请求参数

示例代码

返回响应