查询企业下用户待办列表
POST
/v1.0/todo/users/{unionId}/org/tasks/query最后修改时间:: 2 年前
责任人: 未设置
说明
调用本接口获取该授权企业下某用户的待办列表。
权限
要调用此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
待办完成状态。
示例
{}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
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
}
]
}
最后修改时间: 2 年前