查询企业下用户待办列表

说明

调用本接口获取该授权企业下某用户的待办列表。

权限

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

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

错误码

HttpCode	错误码	错误信息	说明
400	todo.orgTaskQuery.paramError	todo.orgTaskQuery.paramError	查询企业待办列表系统参数错误
500	todo.orgTaskQuery.systemError	todo.orgTaskQuery.systemError	查询企业待办列表系统内部异常

请求参数

Path 参数

unionId

string

必需

用户的unionId，可通过根据userid获取用户详情接口获取。

Header 参数

x-acs-dingtalk-access-token

string

必需

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

Body 参数application/json

nextToken

string

可选

分页游标。
如果一个查询条件一次无法全部返回结果，会返回分页token，下次查询带上该token后会返回后续数据，直到分页token为null表示数据已经全部查询完毕。

isDone

boolean

待办完成状态。

可选

示例

{}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

nextToken

string

可选

下一次请求的token。

todoCards

array [object {11}]

待办卡片列表。

可选

taskId

string

待办ID。

可选

subject

string

待办标题。

可选

dueTime

integer

待办截止时间。

可选

detailUrl

object

详情页链接。

可选

priority

integer

优先级

可选

createdTime

integer

创建时间。

可选

modifiedTime

integer

更新时间。

可选

creatorId

string

创建者ID。

可选

sourceId

string

来源ID。

可选

bizTag

string

所属应用。

可选

isDone

boolean

待办完成状态。

可选

示例

{
  "nextToken": "string",
  "todoCards": [
    {
      "taskId": "string",
      "subject": "string",
      "dueTime": 0,
      "detailUrl": {
        "appUrl": "string",
        "pcUrl": "string"
      },
      "priority": 0,
      "createdTime": 0,
      "modifiedTime": 0,
      "creatorId": "string",
      "sourceId": "string",
      "bizTag": "string",
      "isDone": true
    }
  ]
}

查询企业下用户待办列表

说明#

权限#

错误码#

请求参数

示例代码

返回响应

说明

权限

错误码