列出自建角色组

将角色组全部拉取出来。支持公共模式和集成模式。

接口版本：

接口版本	更新时间	版本说明
v2	2022.4.8	初始版本：角色使用 role_no角色组使用 group_no包含 integrate_id, type 字段
v4	2022.6.30	返回值新增字段 status
v5	2022.10.28	在 v4 的基础上，接口请求频率由 5 次/秒提升至 30 次/秒；接口路由修改为 POST corp/role_group/list

请求地址：https://api.jiandaoyun.com/api/v5/corp/role_group/list

**请求频率：**30 次/秒

请求方式：POST

请求参数:

参数	类型	是否必需	说明
skip	Integer	否	偏移量
limit	Integer	否	limit
has_internal	Boolean	否	是否包含自建角色组默认为 true
has_sync	Boolean	否	是否包含集成角色组默认为 true

请求示例：

{
    "skip": 0,
    "limit": 3,
    "has_internal": ture,
    "has_sync": ture
}

响应内容：

参数	类型	是否必需	说明
group_no	Number	是	角色组编号
name	String	是	角色组名称
type	Number	是	角色组类型0: 常规角色组2: 企业互联外部角色组
status	Number	是	1: 使用中
integrate_id	String	否	集成模式同步角色关联 ID，仅在集成模式下返回

返回示例：

{
    "role_groups": [
        {
            "group_no": 2547,
            "name": "默认",
            "type": 0
            "status": 1
        },
        {
            "group_no": 2550,
            "name": "CRM角色组",
            "type": 0
            "status": 1
        },
        {
            "group_no": 2556,
            "name": "营销中心",
            "type": 0
            "status": 1
        }
    ]
}

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数application/json

skip

integer

偏移量

可选

limit

number

limit

可选

has_internal

boolean

可选

是否包含自建角色组默认为 true

has_sync

boolean

可选

是否包含集成角色组默认为 true

示例

{
    "skip": 0,
    "limit": 3,
    "has_internal": true,
    "has_sync": true
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

role_groups

array [object {4}]

必需

group_no

number

角色组编号

必需

name

string

角色组名称

必需

type

number

必需

角色组类型 0: 常规角色组 2: 企业互联外部角色组

status

number

1: 使用中

必需

示例

{
    "role_groups": [
        {
            "group_no": 2547,
            "name": "默认",
            "type": 0,
            "status": 1
        },
        {
            "group_no": 2550,
            "name": "CRM角色组",
            "type": 0,
            "status": 1
        },
        {
            "group_no": 2556,
            "name": "营销中心",
            "type": 0,
            "status": 1
        }
    ]
}

列出自建角色组