查询企业下用户待办列表

说明

调用本接口分页获取用户的待办任务列表。
服务地址：https://oapi.dingtalk.com

权限

服务端API是以应用维度授权的，在调用接口前，确保已经为应用添加了接口权限。详情请参考权限申请。

应用类型	是否支持调用	权限申请方式	API Explorer调试
企业内部应用	是	开发者后台申请	调试
第三方企业应用	否	—	—
第三方个人应用	否	—	—

错误码

错误码	错误码说明	排查方法
40068	无效的offset	offset不能小于0。
40069	无效的limit	limit必须在0和50之间。
33012	无效的userid	请检查userid参数是否合法。

请求参数

Query 参数

access_token

string

必需

调用服务端API授权凭证，可通过获取企业内部应用的access_token接口获取。

示例值:

6d1bxxxx

Body 参数application/json

userid

string

必需

要查询的用户userid。

offset

number

必需

分页游标，从0开始，如返回结果中has_more为true，则表示还有数据，offset再传上一次的offset+limit。

limit

number

必需

分页大小，最多50。

status

number

必需

待办任务状态：0：未完成1：完成

示例

{
  "offset": "0",
  "limit": "50",
  "userid": "manager7080",
  "status": "0"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

request_id

string

请求ID。

可选

errcode

number

返回码。

可选

errmsg

string

返回码描述。

可选

records

object

查询结果。

可选

has_more

boolean

可选

是否有更多数据：true：有false：没有

list

array [object {5}]

待办列表。

可选

示例

{
  "request_id": "string",
  "errcode": 0,
  "errmsg": "string",
  "records": {
    "has_more": true,
    "list": [
      {
        "record_id": "string",
        "create_time": 0,
        "title": "string",
        "url": "string",
        "forms": [
          {
            "title": "string",
            "content": "string"
          }
        ]
      }
    ]
  }
}

查询企业下用户待办列表

说明#

权限#

错误码#

请求参数

示例代码

返回响应

说明

权限

错误码