获取角色列表

正式环境

https://api.mingdao.com

GET

/v3/app/roles

获取应用下角色列表

请求参数

Header 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://api.mingdao.com/v3/app/roles' \
--header 'HAP-Appkey: {{appkey}}' \
--header 'HAP-Sign: {{sign}}'

返回响应

🟢200成功

application/json

Body

示例

{
    "data": {
        "roles": [
            {
                "id": "角色Id",
                "name": "角色名称",
                "roleType": "角色类型",
                "desc": "角色描述",
                "accounts": [
                    {
                        "id": "账号Id",
                        "name": "用户名",
                        "avatar": "用户头像链接"
                    }
                ],
                "departmentTrees": [
                    {
                        "id": "部门Id",
                        "name": "部门名称"
                    }
                ],
                "departments": [
                    {
                        "id": "部门Id",
                        "name": "部门名称"
                    }
                ],
                "jobs": [
                    {
                        "id": "职位Id",
                        "name": "职位名称"
                    }
                ],
                "orgRoleIds": [
                    "组织角色ID"
                ]
            }
        ]
    },
    "success": true
}

修改于 2025-09-05 07:02:57

触发流程

创建角色