跳到主要内容

更新单条数据的信息

调用本接口,更新指定数据的信息


权限说明

「超管accessToken」和「权限组accessToken」都可以调用,「权限组accessToken」须具有对应应用的权限。

请求

**请求方式:**POST

**请求地址:**https://api.qingflow.com/\{appKey\}/apply/\{applyId\}(公有云版本)

请求地址中:applyId为需要替换的变量,根据实际获取值更新,示例如下:

POST https://api.qingflow.com/123456/apply/123456

其他版本请求地址:

钉钉版本:https://api.ding.qingflow.com/{appKey}/apply/{applyId}

专有轻流:http(s)://xxx.xx(自有域名)/openApi/{appKey}/apply/{applyId}

2.1 参数说明(路径参数):

参数必须说明
appKey应用 id,获取方式详见:基本概念介绍
applyId数据的id,可在轻流的URL中获取,或通过调用文档接口获取

2.2 参数说明(查询参数):

2.2.1 请求头(Header)
参数必须说明
accessToken调用接口凭证。获取方法请查看“文档”
2.2.2 请求体(Body)
参数必须类型说明
answersarray
queIdint必填,更新数据中字段的id,可通过文档接口获取specialQueId可见文档
queTitlestring更新数据中字段的title
queTypeint字段类型,必填,queType可见文档
valuesarray["$ref:answerValue"] 表格字段以外的字段类型必填,以下三项可按需选填
valuestring问题的结果值
otherInfostring问题结果的其他信息
idint
tableValuesarray[["$ref:answerDetail"]] 表格类型字段必填
2.2.3 请求体示例
{
"answers":
[ { "queId":36091911,
"values":[{"value":"唐浒"}]
} ]
}

返回

3.1 返回体

参数必含类型说明
errCodeint错误码,0表示成功,非0表示失败(注:结果只代表请求发送是否成功,不代表执行结果是否成功,执行结果可使用返回的reqesutId通过“查询操作结果”接口查询
errMsgstring错误描述
questionRelationsarray与表单题目相关的逻辑关系(如显隐、依赖等),成功时为空,只有在某些接口需要时才返回具体内容。
resultobject返回结果
applyIdstring/null通常为单条表单数据的 ID
applyIdsarray当操作为批量提交、批量查询时,返回所有相关 ID。为空数组表示没有数据或是单条操作。
requestIdstring请求Id

3.2 返回体示例

{
"errCode": 0,
"errMsg": null,
"questionRelations": [],
"result": {
"applyId": null,
"applyIds": [],
"requestId": "8282ffb1-d76b-4be9-bf58-276d9f083740"
}
}

注意事项

1、更新数据后您可在对应数据的流程日志中查看到更新记录(如下图) 文档图片

2、若您更新的数据中,有成员字段,请注意:

我们增加了"optionId"参数(非必填),您可以在这个参数中使用您在通讯录中获取的成员userId代替原来的"id"参数。示例如下:

"answers":[
{
"queId":4233988,
"queTitle":"成员字段",
"queType":5,
"values":[
{"optionId": "12345",
"queId": 4233988,
"value": "刘XX"} ]
}
]