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

scope: approvalRole:list

body参数

名称	类型	是否必填	描述
corpId	String	是	企业ID
groupId	String	否	分组ID，传入则查询指定分组下的角色
roleName	String	否	角色名称，支持模糊搜索

返回参数

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

data 数组元素结构

名称	类型	描述
roleId	String	角色ID
groupId	String	所属分组ID
roleName	String	角色名称
desc	String	角色说明
empIds	Array of Object	角色关联的员工列表

empIds 数组元素结构

名称	类型	描述
label	String	员工姓名
value	String	员工ID
order	Integer	排序序号（可能为null）
status	String	状态（可能为null）

返回示例

{
    "data": [
        {
            "roleId": "696f17d7e4b01626be4676b4",
            "groupId": "696f15cce4b01626be467699",
            "roleName": "zcb测试开放接口角色1",
            "empIds": [
                {
                    "label": "zcb（勿删）",
                    "value": "emp_4bc9a5e1bd334eb6bf075e4bc8a991d6",
                    "order": null,
                    "status": null
                }
            ],
            "desc": "1111"
        }
    ],
    "success": true,
    "errorCode": null,
    "errorMsg": null
}

注意事项

返回顺序：角色列表按创建时间升序排列

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

分组过滤：groupId 可通过 /open/api/v1/approvalRole/group/list 接口获取

模糊搜索：roleName 参数为包含匹配，即角色名称中包含该关键字即可匹配

员工信息：empIds 中的 label 为员工姓名，value 为员工ID；order 和 status 在当前场景下通常为 null

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200

application/json

Bodyapplication/json

示例

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

{
  "data": [
    {
      "roleId": "",
      "groupId": "",
      "roleName": "",
      "empIds": [
        {
          "label": "",
          "value": "",
          "order": 0,
          "status": ""
        }
      ],
      "desc": ""
    }
  ],
  "success": false,
  "errorCode": "",
  "errorMsg": ""
}

获取审批角色列表

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

body参数#

返回参数#

data 数组元素结构#

empIds 数组元素结构#

返回示例#

注意事项#

请求参数