保存表单数据

POST

http://127.0.0.1/v1.0/yida/forms/instances

新版服务端API（DingTalk OpenAPI）/宜搭应用开发/表单

最后修改时间：2022-08-30 09:19:23

责任人：未设置

说明

调用本接口新增一条宜搭表单实例，表单唯一ID由入参指定。
服务地址：api.dingtalk.com

权限

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

应用类型	是否支持	权限	API Explorer调试
企业内部应用	支持	宜搭表单数据写权限	API Explorer
第三方企业应用	支持	宜搭表单数据写权限	API Explorer
第三方个人应用	暂不支持	宜搭表单数据写权限	暂不支持

错误码

HttpCode	错误码	错误信息	说明
400	invalidParameter.methodInputs.invalidFormat	数据格式错误:%s	数据格式错误
400	invalidParameter.number.exceed	数字超过限制:%s	数字超过限制
400	dataNotExist.form.notExists	表单不存在:%s	表单不存在
400	invalidParameter.methodInputs.invalid	入参校验失败:%s	入参校验失败
500	dataModified.form.formAlreadyModified	实例数据已修改, 请刷新当前页面:%s	实例数据已经修改
500	unclassifiedError	异常:%s	通用异常信息

请求参数

Header 参数

x-acs-dingtalk-access-token

string

必需

调用该接口的访问凭证。如何获取不同应用的凭证请参考访问凭证概述。

Body 参数application/json

appType

string

应用ID。

必需

systemToken

string

应用秘钥。

必需

userId

string

必需

用户的userid。

language

string

语言，取值：

可选

formUuid

string

表单ID。

必需

formDataJson

string

表单数据。

必需

示例

{}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://127.0.0.1/v1.0/yida/forms/instances' \
--header 'x-acs-dingtalk-access-token;' \
--header 'Content-Type: application/json' \
--data-raw '{}'

返回响应

🟢200成功

application/json

Body

result

string

表单实例ID。

可选

示例

{
  "result": "string"
}

查询表单实例数据

更新表单数据

保存表单数据

说明#

权限#

错误码#

请求参数

示例代码

返回响应

说明

权限

错误码