获取审批角色分组列表

生产环境

https://app91651.eapps.dingtalkcloud.com

POST

/open/api/v1/approvalRole/group/list

接口文档：获取审批角色分组列表

scope: approvalRole:group:list

body参数

名称	类型	是否必填	描述
corpId	String	是	企业ID

返回参数

名称	类型	描述
success	Boolean	接口是否响应成功
errorCode	String	错误码（成功时为null）
errorMsg	String	错误提示原因（成功时为null）
data	Array of Object	审批角色分组列表

data 数组元素结构

名称	类型	描述
groupId	String	分组ID
groupName	String	分组名称

返回示例

{
    "data": [
        {
            "groupId": "67f8a9af184f4d6e069bc324",
            "groupName": "测试1"
        },
        {
            "groupId": "67f8b835184f4d6e069bc39e",
            "groupName": "审批流测试角色2"
        },
        {
            "groupId": "67f8b85c184f4d6e069bc3a2",
            "groupName": "审批流测试角色1"
        }
    ],
    "success": true,
    "errorCode": null,
    "errorMsg": null
}

注意事项

返回顺序：分组列表按创建时间升序排列

空列表：如果企业下没有审批角色分组，data 返回空数组 []

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json

示例

{
    "corpId": "string"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://app91651.eapps.dingtalkcloud.com/open/api/v1/approvalRole/group/list' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "corpId": "string"
}'

返回响应

🟢200

application/json

Bodyapplication/json

示例

成功示例成功示例成功示例

{
  "data": [
    {
      "groupId": "",
      "groupName": ""
    }
  ],
  "success": false,
  "errorCode": "",
  "errorMsg": ""
}

修改于 2026-02-04 02:51:51

合同公司列表

创建审批角色分组

获取审批角色分组列表

接口文档：获取审批角色分组列表#

body参数#

返回参数#

data 数组元素结构#

返回示例#

注意事项#