应用 API
  1. 角色
应用 API
  • V3-beta(AI 友好)
    • 概述
    • 字段类型对照表
    • 筛选器使用指南
    • 错误码
    • 应用
      • 获取应用信息
    • 工作表
      • 获取工作表结构信息
      • 编辑工作表
      • 删除工作表
      • 新建工作表
    • 工作表行记录
      • 获取行记录列表
      • 获取行记录详情
      • 新建行记录
      • 更新行记录
      • 删除行记录
      • 批量新增行记录
      • 批量更新行记录
      • 批量删除行记录
      • 获取关联记录
      • 获取行记录透视数据
      • 获取记录分享链接
      • 获取行记录日志
      • 获取行记录讨论
    • 选项集
      • 获取选项集列表
      • 创建选项集
      • 编辑选项集
      • 删除选项集
    • 工作流
      • 获取流程列表
      • 获取流程详情
      • 触发流程
    • 角色
      • 获取角色列表
      • 创建角色
      • 获取角色详情
      • 删除角色
      • 添加角色成员
      • 移除角色成员
      • 成员退出所有角色
    • 公共查询
      • 查找成员
      • 查找部门
      • 获取地区信息
  • V2
    • 开发指南
    • 筛选器
    • 筛选器使用示例
    • 错误码
    • 应用
      • 获取应用信息
    • 工作表
      • 新建工作表
      • 获取工作表结构信息
      • 获取行记录列表
      • 新建行记录
      • 批量新建行记录
      • 获取行记录详情
      • 获取行记录详情
      • 更新行记录详情
      • 批量更新行记录详情
      • 删除行记录
      • 获取关联记录
      • 获取记录分享链接
      • 获取工作表总行数
      • 获取行记录日志
      • 获取行记录讨论
    • 角色
      • 创建角色
        POST
      • 退出应用
        POST
      • 删除角色
        POST
      • 添加角色成员
        POST
      • 移除应用角色成员
        POST
      • 获取角色列表
        GET
      • 获取角色详情
        GET
    • 选项集
      • 创建选项集
      • 获取选项集
      • 编辑选项集
      • 删除选项集
    • 公共查询
      • 获取地区信息
  1. 角色

创建角色

正式环境
https://api.mingdao.com
正式环境
https://api.mingdao.com
POST
/v1/open/app/createRole
创建角色
信息包含:角色名称、描述、权限信息

请求参数

Body 参数application/json

示例
{
    "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
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.mingdao.com/v1/open/app/createRole' \
--header 'Authorization: Bearer <token>' \
--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": {
        "roleId": "6825715d-92cc-4e15-83ce-8e39d1a667bc",
        "name": "新角色40",
        "roleType": 0,
        "desc": "",
        "users": [],
        "departments": [],
        "departmentTrees": [],
        "projectOrganizes": [],
        "jobs": []
    },
    "success": true,
    "error_code": 1
}
🟠401没有权限
🟠404记录不存在
修改于 2025-06-26 06:39:13
上一页
获取行记录讨论
下一页
退出应用
Built with