创建角色

正式环境

https://api.mingdao.com

POST

/v3/app/roles

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

请求参数

Header 参数

Body 参数application/json

示例

{
    "name": "string",
    "description": "string",
    "permissionScope": 80,
    "type": 0,
    "hideAppForMembers": true,
    "globalPermissions": {
        "addRecord": true,
        "share": true,
        "import": true,
        "export": true,
        "discuss": true,
        "systemPrint": true,
        "attachmentDownload": true,
        "log": true
    },
    "worksheetPermissions": [
        {
            "id": "string",
            "recordPermissionInViews": [
                {
                    "viewId": "string",
                    "read": true,
                    "edit": true,
                    "delete": true
                }
            ],
            "recordDataScope": {
                "read": 0,
                "edit": 0,
                "delete": 0
            },
            "worksheetActions": {
                "shareView": true,
                "import": true,
                "export": true,
                "discuss": true,
                "batchOperation": true
            },
            "recordActions": {
                "add": true,
                "share": true,
                "discuss": true,
                "systemPrint": true,
                "attachmentDownload": true,
                "log": true
            },
            "paymentActions": {
                "pay": "string"
            },
            "fieldPermissions": [
                {
                    "id": "string",
                    "add": true,
                    "read": true,
                    "edit": true,
                    "decrypt": true
                }
            ]
        }
    ],
    "pagePermissions": [
        {
            "id": "string",
            "enable": true
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.mingdao.com/v3/app/roles' \
--header 'HAP-Appkey: {{appkey}}' \
--header 'HAP-Sign: {{sign}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "string",
    "description": "string",
    "permissionScope": 80,
    "type": 0,
    "hideAppForMembers": true,
    "globalPermissions": {
        "addRecord": true,
        "share": true,
        "import": true,
        "export": true,
        "discuss": true,
        "systemPrint": true,
        "attachmentDownload": true,
        "log": true
    },
    "worksheetPermissions": [
        {
            "id": "string",
            "recordPermissionInViews": [
                {
                    "viewId": "string",
                    "read": true,
                    "edit": true,
                    "delete": true
                }
            ],
            "recordDataScope": {
                "read": 0,
                "edit": 0,
                "delete": 0
            },
            "worksheetActions": {
                "shareView": true,
                "import": true,
                "export": true,
                "discuss": true,
                "batchOperation": true
            },
            "recordActions": {
                "add": true,
                "share": true,
                "discuss": true,
                "systemPrint": true,
                "attachmentDownload": true,
                "log": true
            },
            "paymentActions": {
                "pay": "string"
            },
            "fieldPermissions": [
                {
                    "id": "string",
                    "add": true,
                    "read": true,
                    "edit": true,
                    "decrypt": true
                }
            ]
        }
    ],
    "pagePermissions": [
        {
            "id": "string",
            "enable": true
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

示例

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

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

获取角色列表

获取角色详情