更新钉钉待办任务新版SDK

更新于 2023-08-23调用本接口，更新钉钉待办任务信息及状态。

重要

调用本接口前，接入统一授权套件授权类型必须为申请个人授权，即type=0。

接口调用说明

调用本接口，更新钉钉待办任务信息及状态，ISV在自身应用待办数据被更新后，需调用该接口将钉钉侧待办数据同步更新。

权限

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

应用类型	是否支持	权限	API Explorer调试
企业内部应用	支持	待办应用中待办写权限,待办应用中待办读权限	API Explorer
第三方企业应用	支持	待办应用中待办写权限,待办应用中待办读权限	API Explorer
第三方个人应用	暂不支持	待办应用中待办写权限,待办应用中待办读权限	暂不支持

请求方法

Header参数

名称

类型

是否必填

描述

x-acs-dingtalk-access-token

String

是

调用该接口的访问凭证。

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

Path参数

名称

类型

是否必填

描述

unionId

String

是

当前访问资源所归属用户的unionId，和操作者的unionId保持一致。

企业内部应用，调用查询用户详情接口获取unionid参数值。
第三方企业应用，调用查询用户详情接口获取unionid参数值。

taskId

String

是

待办ID。

Query参数

名称

类型

是否必填

描述

operatorId

String

否

当前操作者的unionId。

企业内部应用，调用查询用户详情接口获取unionid参数值。
第三方企业应用，调用查询用户详情接口获取unionid参数值。

Body参数

名称	类型	是否必填	描述
subject	String	否	待办标题，最大长度1024。
description	String	否	待办描述，最大长度4096。
dueTime	Long	否	截止时间，Unix时间戳，单位毫秒。
done	Boolean	否	完成状态。 true：已完成 false：未完成
executorIds	Array of String	否	执行者的unionId列表，最大数量1000。企业内部应用，调用查询用户详情接口获取unionid参数值。第三方企业应用，调用查询用户详情接口获取unionid参数值。
participantIds	Array of String	否	参与者的unionId列表，最大数量1000。企业内部应用，调用查询用户详情接口获取unionid参数值。第三方企业应用，调用查询用户详情接口获取unionid参数值。

返回参数

名称	类型	描述
result	Boolean	更新结果。true表示成功。

错误码

HttpCode	错误码	错误信息	说明
400	todo.taskUpdate.paramError	todo.taskUpdate.paramError	更新待办参数异常
400	todo.taskUpdate.paramError	subject is oversize	待办标题长度超出限制
400	todo.taskUpdate.paramError	description is oversize	待办描述长度超出限制
400	todo.taskUpdate.paramError	executors is oversize	待办执行人超出限制
400	todo.taskUpdate.paramError	participants is oversize	待办参与人超出限制
400	todo.taskUpdate.paramError	dueTime is invalid	待办截止时间非法
400	todo.taskUpdate.paramError	task not exist	待办任务不存在
400	todo.taskUpdate.paramError	task not belong to bizTag	待办任务不属于该应用
500	todo.taskUpdate.systemError	todo.taskUpdate.systemError	更新待办系统异常

这篇文档是否有帮助？

本页内容