创建角色 - 应用 API

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

请求参数

Query 参数

url

string

可选

Body 参数application/json

name

string

角色名称

必需

description

string

角色描述

必需

permissionWay

string

必需

分发所有应用项, 80：可查看、编辑、删除所有记录; 60：可查看所有记录，但只能编辑、删除自己拥有的记录; 30：可查看加入的，只能编辑、删除自己拥有的记录; 20：对所有记录只有查看权限; 0：分发有权限应用项

roleType

string

角色类型

必需

角色类型 0：自定义角色

hideAppForMembers

string

可选

是否对成员隐藏应用,true：隐藏，false：不隐藏

generalAdd

object

必需

添加权限，true 有权限，false 无权限

enable

boolean

可选

gneralShare

object

必需

分享权限，true 有权限，false 无权限

enable

boolean

可选

generalImport

object

必需

导入权限，true 有权限，false 无权限

enable

boolean

可选

generalExport

object

必需

导出权限，true 有权限，false 无权限

enable

boolean

可选

generalDiscussion

object

必需

讨论权限，true 有权限，false 无权限

enable

boolean

可选

generalLogging

object

必需

日志，true 有权限，false 无权限

enable

boolean

可选

generalSystemPrinting

object

必需

系统打印，true 有权限，false 无权限

enable

boolean

可选

recordShare

object

必需

记录分享，true 有权限，false 无权限

enable

boolean

记录分享

可选

payment

object

必需

支付，true 有权限，false 无权限

enable

boolean

支付

可选

optionalControls

array[string]

可选控件

可选

sheets

array [object {19}]

可选

sheetId

string

工作表Id

可选

canAdd

boolean

是否可添加

可选

readLevelId

string

可选

查看权限级别 0：未授权 20：仅我拥有的 30：我的及下属的 100：全部的

editLevelId

string

可选

编辑权限级别 0：未授权 20：仅我拥有的 30：我的及下属的 100：全部的

removeLevel

string

可选

删除权限级别 0：未授权 20：仅我拥有的 30：我的及下属的 100：全部的

worksheetAddRecord

object

可选

worksheetShareView

object

可选

worksheetImport

object

可选

worksheetExport

object

可选

worksheetDiscuss

object

可选

worksheetLogging

object

可选

worksheetBatchOperation

object

可选

recordAttachmentDownload

object

可选

recordSystemPrinting

object

可选

generalAttachmentDownload

object

可选

recordLogging

object

可选

recordDiscussion

object

可选

views

array [object {6}]

可选

fields

array [object {9}]

可选

pages

array [object {6}]

自定义页面Id集

可选

pageId

string

可选

name

string

可选

checked

boolean

可选

navigateHide

boolean

可选

sortIndex

integer

可选

iconUrl

string

可选

示例

{
    "appKey":"422e5a5d0e570105",
"sign":"MzkzMDY3Mzk1NjM0YjkyNjE1YzI2N2ZhNDEzZGE3ZTQwMzQ3ZWJkNzI1ZDc2NjcxYTdkY2ViMzVhZGJlNTI0Yg==",
    "appId": "bd75405e-4c8e-4dba-8b43-9820c0b53ec2",
    "projectId": "28447959-cf7f-4ae9-9074-8977ce48e2a0",
    "hideAppForMembers": false,
    "roleType": 0,
    "permissionWay": 0,
    "sheets": [
        {
            "sheetId": "67cff5821131169abf7ef611",
            "sheetName": "组织管理",
            "canAdd": true,
            "readLevel": 100,
            "editLevel": 100,
            "removeLevel": 100,
            "views": [
                {
                    "viewId": "67cff5821131169abf7ef615",
                    "viewName": "全部",
                    "canRead": true,
                    "canEdit": true,
                    "canRemove": true,
                    "type": 0
                }
            ],
            "fields": [
                {
                    "fieldId": "ownerid",
                    "type": 26,
                    "fieldName": "拥有者",
                    "notRead": false,
                    "notEdit": false,
                    "notAdd": false,
                    "isDecrypt": false,
                    "isReadField": false,
                    "hideWhenAdded": true,
                    "isHide": false
                }
            ],
             "worksheetAddRecord": {
                "enable": true 
            },
            "worksheetShareView": {
                "enable": true
            },
            "worksheetImport": {
                "enable": true
            },
            "worksheetExport": {
                "enable": true
            },
            "worksheetDiscuss": {
                "enable": true
            },
            "worksheetLogging": {
                "enable": true
            },
            "worksheetBatchOperation": {
                "enable": true
            },
            "recordShare": {
                "enable": true
            },
            "recordDiscussion": {
                "enable": true
            },
            "recordSystemPrinting": {
                "enable": true
            },
            "recordAttachmentDownload": {
                "enable": true
            },
            "recordLogging": {
                "enable": true
            },
            "payment": {
                "enable": true
            }
        }
        
    ],
    "extendAttrs": [],
    "optionalControls": [],
    "pages": [
        {
            "pageId": "67617eef1657b7ae33be5ae2",
            "name": "0",
            "checked": true,
            "navigateHide": false,
            "sortIndex": 8,
            "iconUrl": "https://fp1.mingdaoyun.cn/customIcon/dashboard.svg"
        }
    ],
    "roleCategory": 0,
    "generalAdd": {
        "enable": true
    },
    "gneralShare": {
        "enable": true
    },
    "generalImport": {
        "enable": true
    },
    "generalExport": {
        "enable": true
    },
    "generalDiscussion": {
        "enable": true
    },
    "generalSystemPrinting": {
        "enable": true
    },
    "generalAttachmentDownload": {
        "enable": true
    },
    "generalLogging": {
        "enable": true
    },
    "description": "",
    "name": "新角色40"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.mingdao.com/v1/open/app/createRole?url=' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appKey":"422e5a5d0e570105",
"sign":"MzkzMDY3Mzk1NjM0YjkyNjE1YzI2N2ZhNDEzZGE3ZTQwMzQ3ZWJkNzI1ZDc2NjcxYTdkY2ViMzVhZGJlNTI0Yg==",
    "appId": "bd75405e-4c8e-4dba-8b43-9820c0b53ec2",
    "projectId": "28447959-cf7f-4ae9-9074-8977ce48e2a0",
    "hideAppForMembers": false,
    "roleType": 0,
    "permissionWay": 0,
    "sheets": [
        {
            "sheetId": "67cff5821131169abf7ef611",
            "sheetName": "组织管理",
            "canAdd": true,
            "readLevel": 100,
            "editLevel": 100,
            "removeLevel": 100,
            "views": [
                {
                    "viewId": "67cff5821131169abf7ef615",
                    "viewName": "全部",
                    "canRead": true,
                    "canEdit": true,
                    "canRemove": true,
                    "type": 0
                }
            ],
            "fields": [
                {
                    "fieldId": "ownerid",
                    "type": 26,
                    "fieldName": "拥有者",
                    "notRead": false,
                    "notEdit": false,
                    "notAdd": false,
                    "isDecrypt": false,
                    "isReadField": false,
                    "hideWhenAdded": true,
                    "isHide": false
                }
            ],
             "worksheetAddRecord": {
                "enable": true 
            },
            "worksheetShareView": {
                "enable": true
            },
            "worksheetImport": {
                "enable": true
            },
            "worksheetExport": {
                "enable": true
            },
            "worksheetDiscuss": {
                "enable": true
            },
            "worksheetLogging": {
                "enable": true
            },
            "worksheetBatchOperation": {
                "enable": true
            },
            "recordShare": {
                "enable": true
            },
            "recordDiscussion": {
                "enable": true
            },
            "recordSystemPrinting": {
                "enable": true
            },
            "recordAttachmentDownload": {
                "enable": true
            },
            "recordLogging": {
                "enable": true
            },
            "payment": {
                "enable": true
            }
        }
        
    ],
    "extendAttrs": [],
    "optionalControls": [],
    "pages": [
        {
            "pageId": "67617eef1657b7ae33be5ae2",
            "name": "0",
            "checked": true,
            "navigateHide": false,
            "sortIndex": 8,
            "iconUrl": "https://fp1.mingdaoyun.cn/customIcon/dashboard.svg"
        }
    ],
    "roleCategory": 0,
    "generalAdd": {
        "enable": true
    },
    "gneralShare": {
        "enable": true
    },
    "generalImport": {
        "enable": true
    },
    "generalExport": {
        "enable": true
    },
    "generalDiscussion": {
        "enable": true
    },
    "generalSystemPrinting": {
        "enable": true
    },
    "generalAttachmentDownload": {
        "enable": true
    },
    "generalLogging": {
        "enable": true
    },
    "description": "",
    "name": "新角色40"
}'

返回响应

🟢200成功

application/json

Body

data

object

必需

roleId

string

角色 id

必需

name

string

角色名称

必需

roleType

integer

角色类型

必需

desc

string

描述

必需

users

array[string]

用户信息

必需

departments

array[string]

部门

必需

departmentTrees

array[string]

部门树

必需

projectOrganizes

array[string]

组织角色

必需

jobs

array[string]

职位

必需

success

boolean

必需

error_code

integer

必需

示例

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

🟠401没有权限

🟠404记录不存在