- 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": "768c67ed-450e-4d37-abce-eb43085a069d",
"description": "负责开拓与跟进客户、产品试用、销售商机及合同回款管理。对自己负责的数据有完全操作权限。",
"name": "销售代表",
"pagePermissions": [
{
"enable": true,
"id": "6a0e7647f5345631336e299a"
},
{
"enable": false,
"id": "6a0e7648f5345631336e299c"
}
],
"permissionScope": "0",
"type": "0",
"worksheetPermissions": [
{
"fieldPermissions": [],
"id": "6a0d993a2a6f80f730e8829e",
"paymentActions": {
"pay": false
},
"recordActions": {
"add": true,
"attachmentDownload": true,
"discuss": true,
"log": false,
"share": false,
"systemPrint": true
},
"recordDataScope": {
"delete": 20,
"edit": 20,
"read": 100
},
"recordPermissionInViews": [],
"worksheetActions": {
"batchOperation": false,
"discuss": true,
"export": false,
"import": false,
"shareView": false
}
},
{
"fieldPermissions": [],
"id": "6a0d98bc20395ae07d77afa7",
"paymentActions": {
"pay": false
},
"recordActions": {
"add": false,
"attachmentDownload": true,
"discuss": true,
"log": false,
"share": false,
"systemPrint": true
},
"recordDataScope": {
"delete": 0,
"edit": 0,
"read": 100
},
"recordPermissionInViews": [],
"worksheetActions": {
"batchOperation": false,
"discuss": true,
"export": false,
"import": false,
"shareView": false
}
},
{
"fieldPermissions": [],
"id": "6a0d99442a6f80f730e882c2",
"paymentActions": {
"pay": false
},
"recordActions": {
"add": true,
"attachmentDownload": true,
"discuss": true,
"log": false,
"share": false,
"systemPrint": true
},
"recordDataScope": {
"delete": 20,
"edit": 20,
"read": 100
},
"recordPermissionInViews": [],
"worksheetActions": {
"batchOperation": false,
"discuss": true,
"export": false,
"import": false,
"shareView": false
}
},
{
"fieldPermissions": [],
"id": "6a0d99522c250236bae302ed",
"paymentActions": {
"pay": false
},
"recordActions": {
"add": true,
"attachmentDownload": true,
"discuss": true,
"log": false,
"share": false,
"systemPrint": true
},
"recordDataScope": {
"delete": 20,
"edit": 20,
"read": 100
},
"recordPermissionInViews": [],
"worksheetActions": {
"batchOperation": false,
"discuss": true,
"export": false,
"import": false,
"shareView": false
}
},
{
"fieldPermissions": [],
"id": "6a0d995c632550d31d37e910",
"paymentActions": {
"pay": false
},
"recordActions": {
"add": true,
"attachmentDownload": true,
"discuss": true,
"log": false,
"share": false,
"systemPrint": true
},
"recordDataScope": {
"delete": 20,
"edit": 20,
"read": 100
},
"recordPermissionInViews": [],
"worksheetActions": {
"batchOperation": false,
"discuss": true,
"export": false,
"import": false,
"shareView": false
}
},
{
"fieldPermissions": [],
"id": "6a0d9969cb1d0c2eab5f8a67",
"paymentActions": {
"pay": false
},
"recordActions": {
"add": true,
"attachmentDownload": true,
"discuss": true,
"log": false,
"share": false,
"systemPrint": true
},
"recordDataScope": {
"delete": 20,
"edit": 20,
"read": 100
},
"recordPermissionInViews": [],
"worksheetActions": {
"batchOperation": false,
"discuss": true,
"export": false,
"import": false,
"shareView": false
}
},
{
"fieldPermissions": [],
"id": "6a0d99732a6f80f730e882e1",
"paymentActions": {
"pay": false
},
"recordActions": {
"add": true,
"attachmentDownload": true,
"discuss": true,
"log": false,
"share": false,
"systemPrint": true
},
"recordDataScope": {
"delete": 20,
"edit": 20,
"read": 100
},
"recordPermissionInViews": [],
"worksheetActions": {
"batchOperation": false,
"discuss": true,
"export": false,
"import": false,
"shareView": false
}
},
{
"fieldPermissions": [],
"id": "6a0d997ccb1d0c2eab5f8a69",
"paymentActions": {
"pay": false
},
"recordActions": {
"add": true,
"attachmentDownload": true,
"discuss": true,
"log": false,
"share": false,
"systemPrint": true
},
"recordDataScope": {
"delete": 20,
"edit": 20,
"read": 100
},
"recordPermissionInViews": [],
"worksheetActions": {
"batchOperation": false,
"discuss": true,
"export": false,
"import": false,
"shareView": false
}
},
{
"fieldPermissions": [],
"id": "6a0d9989860381864a656f6f",
"paymentActions": {
"pay": false
},
"recordActions": {
"add": true,
"attachmentDownload": true,
"discuss": true,
"log": false,
"share": false,
"systemPrint": true
},
"recordDataScope": {
"delete": 20,
"edit": 20,
"read": 100
},
"recordPermissionInViews": [],
"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;' \
--header 'HAP-Sign;' \
--header 'Content-Type: application/json' \
--data '{
"appId": "768c67ed-450e-4d37-abce-eb43085a069d",
"description": "负责开拓与跟进客户、产品试用、销售商机及合同回款管理。对自己负责的数据有完全操作权限。",
"name": "销售代表",
"pagePermissions": [
{
"enable": true,
"id": "6a0e7647f5345631336e299a"
},
{
"enable": false,
"id": "6a0e7648f5345631336e299c"
}
],
"permissionScope": "0",
"type": "0",
"worksheetPermissions": [
{
"fieldPermissions": [],
"id": "6a0d993a2a6f80f730e8829e",
"paymentActions": {
"pay": false
},
"recordActions": {
"add": true,
"attachmentDownload": true,
"discuss": true,
"log": false,
"share": false,
"systemPrint": true
},
"recordDataScope": {
"delete": 20,
"edit": 20,
"read": 100
},
"recordPermissionInViews": [],
"worksheetActions": {
"batchOperation": false,
"discuss": true,
"export": false,
"import": false,
"shareView": false
}
},
{
"fieldPermissions": [],
"id": "6a0d98bc20395ae07d77afa7",
"paymentActions": {
"pay": false
},
"recordActions": {
"add": false,
"attachmentDownload": true,
"discuss": true,
"log": false,
"share": false,
"systemPrint": true
},
"recordDataScope": {
"delete": 0,
"edit": 0,
"read": 100
},
"recordPermissionInViews": [],
"worksheetActions": {
"batchOperation": false,
"discuss": true,
"export": false,
"import": false,
"shareView": false
}
},
{
"fieldPermissions": [],
"id": "6a0d99442a6f80f730e882c2",
"paymentActions": {
"pay": false
},
"recordActions": {
"add": true,
"attachmentDownload": true,
"discuss": true,
"log": false,
"share": false,
"systemPrint": true
},
"recordDataScope": {
"delete": 20,
"edit": 20,
"read": 100
},
"recordPermissionInViews": [],
"worksheetActions": {
"batchOperation": false,
"discuss": true,
"export": false,
"import": false,
"shareView": false
}
},
{
"fieldPermissions": [],
"id": "6a0d99522c250236bae302ed",
"paymentActions": {
"pay": false
},
"recordActions": {
"add": true,
"attachmentDownload": true,
"discuss": true,
"log": false,
"share": false,
"systemPrint": true
},
"recordDataScope": {
"delete": 20,
"edit": 20,
"read": 100
},
"recordPermissionInViews": [],
"worksheetActions": {
"batchOperation": false,
"discuss": true,
"export": false,
"import": false,
"shareView": false
}
},
{
"fieldPermissions": [],
"id": "6a0d995c632550d31d37e910",
"paymentActions": {
"pay": false
},
"recordActions": {
"add": true,
"attachmentDownload": true,
"discuss": true,
"log": false,
"share": false,
"systemPrint": true
},
"recordDataScope": {
"delete": 20,
"edit": 20,
"read": 100
},
"recordPermissionInViews": [],
"worksheetActions": {
"batchOperation": false,
"discuss": true,
"export": false,
"import": false,
"shareView": false
}
},
{
"fieldPermissions": [],
"id": "6a0d9969cb1d0c2eab5f8a67",
"paymentActions": {
"pay": false
},
"recordActions": {
"add": true,
"attachmentDownload": true,
"discuss": true,
"log": false,
"share": false,
"systemPrint": true
},
"recordDataScope": {
"delete": 20,
"edit": 20,
"read": 100
},
"recordPermissionInViews": [],
"worksheetActions": {
"batchOperation": false,
"discuss": true,
"export": false,
"import": false,
"shareView": false
}
},
{
"fieldPermissions": [],
"id": "6a0d99732a6f80f730e882e1",
"paymentActions": {
"pay": false
},
"recordActions": {
"add": true,
"attachmentDownload": true,
"discuss": true,
"log": false,
"share": false,
"systemPrint": true
},
"recordDataScope": {
"delete": 20,
"edit": 20,
"read": 100
},
"recordPermissionInViews": [],
"worksheetActions": {
"batchOperation": false,
"discuss": true,
"export": false,
"import": false,
"shareView": false
}
},
{
"fieldPermissions": [],
"id": "6a0d997ccb1d0c2eab5f8a69",
"paymentActions": {
"pay": false
},
"recordActions": {
"add": true,
"attachmentDownload": true,
"discuss": true,
"log": false,
"share": false,
"systemPrint": true
},
"recordDataScope": {
"delete": 20,
"edit": 20,
"read": 100
},
"recordPermissionInViews": [],
"worksheetActions": {
"batchOperation": false,
"discuss": true,
"export": false,
"import": false,
"shareView": false
}
},
{
"fieldPermissions": [],
"id": "6a0d9989860381864a656f6f",
"paymentActions": {
"pay": false
},
"recordActions": {
"add": true,
"attachmentDownload": true,
"discuss": true,
"log": false,
"share": false,
"systemPrint": true
},
"recordDataScope": {
"delete": 20,
"edit": 20,
"read": 100
},
"recordPermissionInViews": [],
"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-21 03:40:31