管理员查询指定员工的待处理任务列表新版SDK
更新于 2025-01-16
特别提醒
当前接口为OA高级版专享接口，升级OA高级版可用，可满足更高级的开发需求，响应个性化的业务场景。查看全部专享OpenAPI
接口功能介绍
本接口为组织管理员提供待处理任务查询服务，通过管理员(managerUserId) 查询当前审批人UserId的所有待处理的OA审批任务信息，支持在职员工和离职员工的待处理任务查询，如下图所示：
权限
要调用此API，需要以下权限之一。
应用类型 | 是否支持 | 权限 | API Explorer调试 |
|---|---|---|---|
| 企业内部应用 | 支持 | OA审批工作流读写权限 | API Explorer |
请求方法
Header参数
名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
x-acs-dingtalk-access-token | String | 是 | 调用该接口的访问凭证：
|
Query参数
名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
nextToken | Integer | 是 | 分页标识，从1开始。 |
maxResults | Integer | 是 | 分页大小，最大值20。 |
actionerUserId | String | 是 | 操作人userId。 |
managerUserId | String | 是 | 管理员userId。 |
返回参数
名称 | 类型 | 描述 |
|---|---|---|
result | Object | 返回结果。 |
hasMore | Boolean | 是否有下一页。 |
list | Array | 结果列表。 |
taskId | Long | OA审批任务ID。 |
processCode | String | 审批模板唯一编码。 |
title | String | 任务标题。 |
businessId | String | 流程实例业务编号ID。 |
processInstanceId | String | 流程实例ID。 |
userId | String | OA审批任务发起人的用户userId。 |
canRedirect | Boolean | 是否可转交。（基础规则，例如外部审批流程任务，不可转交） |
createTime | Long | 审批任务创建时间，时间戳格式。 |
示例
请求示例
返回示例
错误码
HttpCode | 错误码 | 错误信息 | 说明 |
|---|---|---|---|
400 | param.user.notexist | 查询的staffId不存在 | 查询的userId在当前组织不存在 |
400 | param.manager.notexist | 查询的managerUserId不存在 | 查询的managerUserId无管理权限 |
400 | qps.exceed.limit | 请求过于频繁 | 超过调用并发上限 |
400 | oaplus.query.limit | 请求过于频繁，稍后重试 | 企业访问并发超过限制 |
400 | benefit.status.invalid | 权益校验失败，未开通或过期 | 权益校验 |
400 | benefit.query.error | 权益查询失败 | 权益系统查询失败 |
500 | system.error | 系统错误 | 系统错误 |
