批量新增表单业务数据

POST

/v1.0/h3yun/forms/instances/batch

调用本接口可批量新增表单的业务实例数据。

权限

要调用此API，需要以下权限之一。

应用类型	是否支持	权限	API Explorer调试
企业内部应用	支持	氚云数据管理权限	API Explorer
第三方企业应用	支持	氚云数据管理权限	API Explorer
第三方个人应用	暂不支持	氚云数据管理权限	暂不支持

错误码

HttpCode	错误码	错误信息	说明
400	invalidParameter.input.invalid	%s	入参校验失败
400	dataNotExist.user.userNotExist	操作用户不存在	操作用户不存在
400	dataModified.form.batchCreateBizObjectFail	批量创建流程或业务对象全部失败	批量创建流程或业务对象全部失败
500	systemError	系统异常	出现未知的系统错误

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.dingtalk.com/v1.0/h3yun/forms/instances/batch' \
--header 'x-acs-dingtalk-access-token;' \
--header 'Content-Type: application/json' \
--data-raw '{
  "schemaCode" : "String",
  "opUserId" : "String",
  "bizObjectJsonArray" : [ "String" ],
  "isDraft" : Boolean
}'

响应示例

{
    "code": "string",
    "message": "string",
    "data": {
        "bizObjectIds": [
            "string"
        ],
        "processIds": [
            "string"
        ],
        "failedDatas": [
            "string"
        ],
        "failedMessages": [
            "string"
        ]
    }
}

请求参数

Header 参数

x-acs-dingtalk-access-token

string

必需

调用该接口的访问凭证。

企业内部应用，调用获取企业内部应用的accessToken接口获取。

第三方企业应用，调用获取第三方应用授权企业的accessToken接口获取。

Body 参数application/json

schemaCode

string

表单编码。

必需

opUserId

string

操作用户ID。

必需

bizObjectJsonArray

array[string]

必需

待新增的业对象json数组。JSON数组的key只可以调用获取表单对象结构接口获取。

例如：
{
"F0000010": "0000007",
"F0000011": "王五",
"F0000012": "D级客户",
"F0000013": 7000,
"D000183Fcd15f3a51e624bbc9945392d190b6aa8": [
{
"F0000014": "克里斯",
"F0000015": 15600000000,
"F0000016": "技术部",
"F0000017": "经理",
"F0000018": "男",
"F0000019": "lgbxunmi@dd.com",
"F0000020": true,
"F0000021": "这是备注"
}
]
}

示例

返回响应

🟢200成功

application/json

Body

code

string

必需

message

string

必需

data

object

必需

成功新增的业务对象ID数组。

bizObjectIds

array[string]

必需

成功新增的业务对象ID数组。

processIds

array[string]

必需

新增成功的流程实例ID列表。

failedDatas

array[string]

必需

新增失败的数据列表。

failedMessages

array[string]

必需

失败的提示信息列表。

修改于 2024-01-23 09:54:07

修改表单业务对象数据

删除业务对象

批量新增表单业务数据

权限#

错误码#

请求参数

返回响应

权限

错误码