创建角色

正式环境

https://api.mingdao.com

POST

/v3/app/roles

创建角色
信息包含：角色名称、描述、权限信息

请求参数

Header 参数

Body 参数application/json

示例

permissionScope=30 示例permissionScope=0 示例

{
    "name": "测试角色1",
    "description": "测试创建角色",
    "hideAppForMembers": "false",
    "type": "0",
    "permissionScope": "30"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

permissionScope=30 示例permissionScope=0 示例

curl --location 'https://api.mingdao.com/v3/app/roles' \
--header 'HAP-Appkey;' \
--header 'HAP-Sign;' \
--header 'Content-Type: application/json' \
--data '{
    "name": "测试角色1",
    "description": "测试创建角色",
    "hideAppForMembers": "false",
    "type": "0",
    "permissionScope": "30"
}'

返回响应

🟢200成功

application/json

成功创建角色

Bodyapplication/json

示例

{
    "data": {
        "id": "6825715d-92cc-4e15-83ce-8e39d1a667bc",
        "name": "新角色40",
        "roleType": 0,
        "desc": "",
        "users": [],
        "departments": [],
        "departmentTrees": [],
        "projectOrganizes": [],
        "jobs": []
    },
    "success": true
}

修改于 2026-04-15 09:20:03

获取角色列表

获取角色详情