- V3-beta（AI 友好）
- V2
- 数据模型
- Schemas
- options
- relation
- obj_base_response
- obj_field
- obj_filter
- obj_record_row
- obj_record_log
- obj_record_discussion
- obj_pivot_meta
- obj_pivot_dimensions
- obj_pivot_data
- obj_process
- obj_process_detail
- obj_input
- obj_output
- obj_role
- obj_role_permission
- obj_user
- obj_user_desensitized
- obj_department
- obj_custom_page
- obj_optionset
- obj_filter_children
- obj_app
- 鉴权信息
- 人员对象
- 自定义页面
- 应用角色
- 人员信息
- 统计图数值字段参数
- FilterField
- FilterTarget
- 基础返回对象
- ApiError
- DimensionField
- BatchCreateViewsRequest
- memberInfo
- DataScope
- ValueField
- ViewItem
- department_with_path
- Aggregation
- SortField
- BatchCreateViewsResponse
- departmentInfo
- TimeRange
- TimePointDynamic
- regionInfo
- ChartType
- process
- DynamicRangePoint
- process_detail
- CustomDynamicRange
- input
- CustomRange
- CreateChartResponseData
- output
- DimensionItem
- role
- MetricItem
- role_permission
- SortItem
- ButtonItem
- custom_page
- CreateChartRequest
- optionset
- CreateChartData
- ComponentConfig
- field
- CreateChartResponse
- PageComponent
- worksheet
- Position
- filter
- InlineChartConfig
- SaveCustomPageResponseData
- filter_children
- ViewConfig
- record_row
- TextConfig
- ErrorResponse
- discussion
- HtmlConfig
- CarouselConfig
- ButtonActionItem
- ButtonConfig
- TabItem
- TabConfig
- ContainerConfig
- ChartComponent
- SectionComponent
- TextComponent
- HtmlComponent
- ViewComponent
- CarouselComponent
- ButtonComponent
- TabComponent
- ContainerComponent
- SaveCustomPageComponent
- SaveCustomPageRequest
- SaveCustomPageData
- SaveCustomPageResponse
- Schemas
创建角色
正式环境
https://api.mingdao.com
正式环境
https://api.mingdao.com
POST
/v3/app/roles
信息包含：角色名称、描述、权限信息
请求参数
Header 参数
Body 参数application/json
示例
{
"appId": "c90cdb6f-c5a5-432c-b583-e3f19b852908",
"name": "门岗门卫2222",
"description": "负责一线执勤。主要参与访客到达确认、物资出厂核验、白名单车辆查验、交接班登记以及突发事件上报。",
"roleScope": "externalPortal",
"permissionScope": "0",
"ai_description": "创建门岗门卫角色",
"pagePermissions": [
{
"id": "6a18761b570664665cfc19d9",
"enable": true
},
{
"id": "6a18761b570664665cfc19db",
"enable": false
}
],
"worksheetPermissions": [
{
"id": "6a187578300f625c3357c422",
"fieldPermissions": [],
"paymentActions": {
"pay": false
},
"recordActions": {
"add": true,
"attachmentDownload": true,
"discuss": true,
"log": false,
"share": false,
"systemPrint": false
},
"recordDataScope": {
"read": 100,
"edit": 100,
"delete": 20
},
"recordPermissionInViews": [
{
"viewId": "6a1875e8300f625c3357c47c",
"read": true,
"edit": true,
"delete": true
},
{
"viewId": "6a1875e8300f625c3357c47e",
"read": true,
"edit": true,
"delete": true
},
{
"viewId": "6a1875e8300f625c3357c480",
"read": true,
"edit": true,
"delete": true
},
{
"viewId": "6a1875e8300f625c3357c482",
"read": true,
"edit": true,
"delete": true
}
],
"worksheetActions": {
"batchOperation": false,
"discuss": true,
"export": false,
"import": false,
"shareView": false
}
},
{
"id": "6a187570850817f7f1b05f7a",
"fieldPermissions": [],
"paymentActions": {
"pay": false
},
"recordActions": {
"add": true,
"attachmentDownload": true,
"discuss": true,
"log": false,
"share": false,
"systemPrint": false
},
"recordDataScope": {
"read": 100,
"edit": 100,
"delete": 0
},
"recordPermissionInViews": [
{
"viewId": "6a1875ef300f625c3357c48a",
"read": true,
"edit": true,
"delete": false
},
{
"viewId": "6a1875f0300f625c3357c48c",
"read": true,
"edit": true,
"delete": false
}
],
"worksheetActions": {
"batchOperation": false,
"discuss": true,
"export": false,
"import": false,
"shareView": false
}
},
{
"id": "6a187573850817f7f1b05f7d",
"fieldPermissions": [],
"paymentActions": {
"pay": false
},
"recordActions": {
"add": true,
"attachmentDownload": true,
"discuss": true,
"log": false,
"share": false,
"systemPrint": false
},
"recordDataScope": {
"read": 100,
"edit": 20,
"delete": 0
},
"recordPermissionInViews": [
{
"viewId": "6a1875f3300f625c3357c48e",
"read": true,
"edit": true,
"delete": false
},
{
"viewId": "6a1875f3300f625c3357c490",
"read": true,
"edit": true,
"delete": false
},
{
"viewId": "6a1875f3300f625c3357c492",
"read": true,
"edit": true,
"delete": false
}
],
"worksheetActions": {
"batchOperation": false,
"discuss": true,
"export": false,
"import": false,
"shareView": false
}
},
{
"id": "6a187566b478c0699ee6902d",
"fieldPermissions": [],
"paymentActions": {
"pay": false
},
"recordActions": {
"add": false,
"attachmentDownload": true,
"discuss": true,
"log": false,
"share": false,
"systemPrint": false
},
"recordDataScope": {
"read": 100,
"edit": 0,
"delete": 0
},
"recordPermissionInViews": [
{
"viewId": "6a1875e0300f625c3357c474",
"read": true,
"edit": false,
"delete": false
}
],
"worksheetActions": {
"batchOperation": false,
"discuss": true,
"export": false,
"import": false,
"shareView": false
}
},
{
"id": "6a187569300f625c3357c3f0",
"fieldPermissions": [],
"paymentActions": {
"pay": false
},
"recordActions": {
"add": false,
"attachmentDownload": true,
"discuss": true,
"log": false,
"share": false,
"systemPrint": false
},
"recordDataScope": {
"read": 100,
"edit": 0,
"delete": 0
},
"recordPermissionInViews": [
{
"viewId": "6a1875e4300f625c3357c476",
"read": true,
"edit": false,
"delete": false
},
{
"viewId": "6a1875e4300f625c3357c478",
"read": true,
"edit": false,
"delete": false
}
],
"worksheetActions": {
"batchOperation": false,
"discuss": true,
"export": false,
"import": false,
"shareView": false
}
},
{
"id": "6a18756d850817f7f1b05f45",
"fieldPermissions": [],
"paymentActions": {
"pay": false
},
"recordActions": {
"add": false,
"attachmentDownload": true,
"discuss": true,
"log": false,
"share": false,
"systemPrint": false
},
"recordDataScope": {
"read": 100,
"edit": 100,
"delete": 0
},
"recordPermissionInViews": [
{
"viewId": "6a1875ed300f625c3357c484",
"read": true,
"edit": true,
"delete": false
},
{
"viewId": "6a1875ed300f625c3357c486",
"read": true,
"edit": true,
"delete": false
},
{
"viewId": "6a1875ed300f625c3357c488",
"read": true,
"edit": true,
"delete": false
}
],
"worksheetActions": {
"batchOperation": false,
"discuss": true,
"export": false,
"import": false,
"shareView": false
}
}
]
}请求示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
cURL
curl --location 'https://api.mingdao.com/v3/app/roles' \
--header 'HAP-Appkey: 00a2987ffb08dc4d' \
--header 'HAP-Sign: MTNlZWJmNzUzNDY2ZTA5ODBhM2EwYWRhNWQ4ZWVjMzdlMTU1MjY4ZTk5NDgxOTg1MGMwZWEzOTY4OTg2NjNkNg==' \
--header 'Content-Type: application/json' \
--data '{
"appId": "c90cdb6f-c5a5-432c-b583-e3f19b852908",
"name": "门岗门卫2222",
"description": "负责一线执勤。主要参与访客到达确认、物资出厂核验、白名单车辆查验、交接班登记以及突发事件上报。",
"roleScope": "externalPortal",
"permissionScope": "0",
"ai_description": "创建门岗门卫角色",
"pagePermissions": [
{
"id": "6a18761b570664665cfc19d9",
"enable": true
},
{
"id": "6a18761b570664665cfc19db",
"enable": false
}
],
"worksheetPermissions": [
{
"id": "6a187578300f625c3357c422",
"fieldPermissions": [],
"paymentActions": {
"pay": false
},
"recordActions": {
"add": true,
"attachmentDownload": true,
"discuss": true,
"log": false,
"share": false,
"systemPrint": false
},
"recordDataScope": {
"read": 100,
"edit": 100,
"delete": 20
},
"recordPermissionInViews": [
{
"viewId": "6a1875e8300f625c3357c47c",
"read": true,
"edit": true,
"delete": true
},
{
"viewId": "6a1875e8300f625c3357c47e",
"read": true,
"edit": true,
"delete": true
},
{
"viewId": "6a1875e8300f625c3357c480",
"read": true,
"edit": true,
"delete": true
},
{
"viewId": "6a1875e8300f625c3357c482",
"read": true,
"edit": true,
"delete": true
}
],
"worksheetActions": {
"batchOperation": false,
"discuss": true,
"export": false,
"import": false,
"shareView": false
}
},
{
"id": "6a187570850817f7f1b05f7a",
"fieldPermissions": [],
"paymentActions": {
"pay": false
},
"recordActions": {
"add": true,
"attachmentDownload": true,
"discuss": true,
"log": false,
"share": false,
"systemPrint": false
},
"recordDataScope": {
"read": 100,
"edit": 100,
"delete": 0
},
"recordPermissionInViews": [
{
"viewId": "6a1875ef300f625c3357c48a",
"read": true,
"edit": true,
"delete": false
},
{
"viewId": "6a1875f0300f625c3357c48c",
"read": true,
"edit": true,
"delete": false
}
],
"worksheetActions": {
"batchOperation": false,
"discuss": true,
"export": false,
"import": false,
"shareView": false
}
},
{
"id": "6a187573850817f7f1b05f7d",
"fieldPermissions": [],
"paymentActions": {
"pay": false
},
"recordActions": {
"add": true,
"attachmentDownload": true,
"discuss": true,
"log": false,
"share": false,
"systemPrint": false
},
"recordDataScope": {
"read": 100,
"edit": 20,
"delete": 0
},
"recordPermissionInViews": [
{
"viewId": "6a1875f3300f625c3357c48e",
"read": true,
"edit": true,
"delete": false
},
{
"viewId": "6a1875f3300f625c3357c490",
"read": true,
"edit": true,
"delete": false
},
{
"viewId": "6a1875f3300f625c3357c492",
"read": true,
"edit": true,
"delete": false
}
],
"worksheetActions": {
"batchOperation": false,
"discuss": true,
"export": false,
"import": false,
"shareView": false
}
},
{
"id": "6a187566b478c0699ee6902d",
"fieldPermissions": [],
"paymentActions": {
"pay": false
},
"recordActions": {
"add": false,
"attachmentDownload": true,
"discuss": true,
"log": false,
"share": false,
"systemPrint": false
},
"recordDataScope": {
"read": 100,
"edit": 0,
"delete": 0
},
"recordPermissionInViews": [
{
"viewId": "6a1875e0300f625c3357c474",
"read": true,
"edit": false,
"delete": false
}
],
"worksheetActions": {
"batchOperation": false,
"discuss": true,
"export": false,
"import": false,
"shareView": false
}
},
{
"id": "6a187569300f625c3357c3f0",
"fieldPermissions": [],
"paymentActions": {
"pay": false
},
"recordActions": {
"add": false,
"attachmentDownload": true,
"discuss": true,
"log": false,
"share": false,
"systemPrint": false
},
"recordDataScope": {
"read": 100,
"edit": 0,
"delete": 0
},
"recordPermissionInViews": [
{
"viewId": "6a1875e4300f625c3357c476",
"read": true,
"edit": false,
"delete": false
},
{
"viewId": "6a1875e4300f625c3357c478",
"read": true,
"edit": false,
"delete": false
}
],
"worksheetActions": {
"batchOperation": false,
"discuss": true,
"export": false,
"import": false,
"shareView": false
}
},
{
"id": "6a18756d850817f7f1b05f45",
"fieldPermissions": [],
"paymentActions": {
"pay": false
},
"recordActions": {
"add": false,
"attachmentDownload": true,
"discuss": true,
"log": false,
"share": false,
"systemPrint": false
},
"recordDataScope": {
"read": 100,
"edit": 100,
"delete": 0
},
"recordPermissionInViews": [
{
"viewId": "6a1875ed300f625c3357c484",
"read": true,
"edit": true,
"delete": false
},
{
"viewId": "6a1875ed300f625c3357c486",
"read": true,
"edit": true,
"delete": false
},
{
"viewId": "6a1875ed300f625c3357c488",
"read": true,
"edit": true,
"delete": false
}
],
"worksheetActions": {
"batchOperation": false,
"discuss": true,
"export": false,
"import": false,
"shareView": false
}
}
]
}'返回响应
🟢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-05-29 03:56:35