获取指定用户可见的审批表单列表

说明

调用本接口根据员工的userid分页获取该用户可见的审批表单列表，每次最多获取100个表单。
服务地址：https://oapi.dingtalk.com

权限

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

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

请求参数

Query 参数

access_token

string

必需

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

示例值:

6d1bxxxx

Body 参数application/json

userid

string

可选

要查询的员工的userid。不传表示查询企业下所有审批表单。

offset

number

必需

分页游标，从0开始。根据返回结果里的next_cursor是否为空来判断是否还有下一页，且再次调用时offset设置成next_cursor的值。

size

number

必需

分页大小，最大可设置成100。

示例

{
  "userid": "manager7078",
  "offset": 0,
  "size": "100"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

request_id

string

请求ID。

可选

errmsg

string

返回描述。

可选

errcode

number

返回码。

可选

result

object

查询结果。

可选

process_list

array [object {4}]

可见表单列表。

可选

next_cursor

number

可选

下一次分页调用的offset值，当返回结果里没有nextCursor时，表示分页结束。

示例

{
  "request_id": "string",
  "errmsg": "string",
  "errcode": 0,
  "result": {
    "process_list": [
      {
        "name": "string",
        "icon_url": "string",
        "process_code": "string",
        "url": "string"
      }
    ],
    "next_cursor": 0
  }
}

获取指定用户可见的审批表单列表

说明#

权限#

请求参数

示例代码

返回响应

说明

权限