更新单条数据的信息
调用本接口,更新指定数据的信息
权限说明
「超管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)
| 参数 | 必须 | 类型 | 说明 |
|---|---|---|---|
| answers | 是 | array | |
| queId | 是 | int | 必填,更新数据中字段的id,可通过文档接口获取specialQueId可见文档 |
| queTitle | string | 更新数据中字段的title | |
| queType | int | 字段类型,必填,queType可见文档 | |
| values | 是 | array | ["$ref:answerValue"] 表格字段以外的字段类型必填,以下三项可按需选填 |
| value | string | 问题的结果值 | |
| otherInfo | string | 问题结果的其他信息 | |
| id | int | ||
| tableValues | array | [["$ref:answerDetail"]] 表格类型字段必填 |
2.2.3 请求体示例
{
"answers":
[ { "queId":36091911,
"values":[{"value":"唐浒"}]
} ]
}
返回
3.1 返回体
| 参数 | 必含 | 类型 | 说明 |
|---|---|---|---|
| errCode | 是 | int | 错误码,0表示成功,非0表示失败(注:结果只代表请求发送是否成功,不代表执行结果是否成功,执行结果可使用返回的reqesutId通过“查询操作结果”接口查询 |
| errMsg | 是 | string | 错误描述 |
| questionRelations | 否 | array | 与表单题目相关的逻辑关系(如显隐、依赖等),成功时为空,只有在某些接口需要时才返回具体内容。 |
| result | 是 | object | 返回结果 |
| applyId | 否 | string/null | 通常为单条表单数据的 ID |
| applyIds | 否 | array | 当操作为批量提交、批量查询时,返回所有相关 ID。为空数组表示没有数据或是单条操作。 |
| requestId | 是 | string | 请求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"} ]
}
]