Get Users by Role


获取拥有特定角色的用户列表。

请求格式


POST https://{apigw-address}/app-portal-service/v2.3/role/user/assignedList

请求参数(Query)


名称

必需/可选

数据类型

描述

orgId

必需

String

组织 ID。

请求参数(Body)


名称

必需/可选

数据类型

描述

roleId

必需

String

角色 ID。

响应参数


名称

数据类型

描述

data

Data 结构体

角色列表。

Data 结构体


名称

数据类型

描述

users

user 结构体

用户列表。

user 结构体


名称

数据类型

描述

userId

String

用户名 ID。

name

String

用户名。

email

String

用户邮箱。

phone

String

手机号码。

phoneArea

String

手机号码所属区号。

错误码


代码

描述

31400

缺少必要参数。

31404

角色不存在,或本 OU 未获取此应用。

示例

请求示例


url: /app-portal-service/v2.3/role/user/assignedList?orgId=your_org_ID

method: POST

{
    "roleId": "your_role_ID"
}

返回示例


{
    "code": 0,
    "message": "OK",
    "data": {
        "users": [
            {
                "userId": "your_user_ID",
                "email": "your_user_email",
                "phone": "",
                "phoneArea": "",
                "name": "your_user_name"
            }
        ]
    }
}