1. 自定义页面
应用 API
  • 开发指南
  • 字段类型对照表
  • 筛选器使用指南
  • 错误码
  • API 使用指南
  • 应用
    • 获取应用信息
      GET
    • 批量创建应用项分组
      POST
    • 批量创建应用项
      POST
  • 对话机器人
    • 新建对话机器人
      POST
  • 工作表
    • 获取工作表列表
      POST
    • 新建工作表
      POST
    • 获取工作表结构信息
      GET
    • 更新工作表结构
      POST
    • 删除工作表
      DELETE
    • 批量创建自定义动作
      POST
  • 工作表行记录
    • 获取行记录列表
      POST
    • 获取行记录详情
      GET
    • 更新行记录
      PATCH
    • 删除行记录
      DELETE
    • 新建行记录
      POST
    • 批量新增行记录
      POST
    • 批量更新行记录详情
      PATCH
    • 批量删除行记录
      DELETE
    • 获取关联记录
      GET
    • 获取行记录透视数据
      POST
    • 获取记录分享链接
      POST
    • 获取行记录日志
      GET
    • 获取行记录讨论
      GET
    • 获取审批流程执行详情
      GET
    • 根据行记录获取审批流程执行列表
      POST
  • 自定义页面
    • 更新自定义页面
      PUT
  • 选项集
    • 获取选项集列表
    • 创建选项集
    • 编辑选项集
    • 停用选项集
  • 公共查询
    • 查找成员
    • 查找部门
    • 获取地区信息
  • 知识库
    • 获取应用下知识库列表
    • 知识库检索
  • 视图
    • 批量创建视图
  • 统计图
    • 新建统计图
  • 工作流
    • 获取触发流程列表
    • 创建工作流
    • 批量添加工作流节点
    • 删除工作流节点
    • 触发流程
    • 获取触发流程详情
    • 删除工作流
    • 获取工作流结构详情
    • 发布工作流
    • 校验工作流
  • 角色
    • 获取角色列表
    • 创建角色
    • 获取角色详情
    • 删除角色
    • 添加角色成员
    • 移除角色成员
    • 成员退出所有角色
  • 数据模型
    • 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
    • BatchCreateViewsRequest
    • DataScope
    • ViewItem
    • Aggregation
    • BatchCreateViewsResponse
    • TimeRange
    • ChartType
    • DynamicRangePoint
    • DimensionItem
    • MetricItem
    • SortItem
    • CreateChartData
    • InlineChartConfig
    • ViewConfig
    • TextConfig
    • HtmlConfig
    • CarouselConfig
    • ButtonActionItem
    • ButtonConfig
    • TabConfig
    • ContainerConfig
    • ChartComponent
    • SectionComponent
    • TextComponent
    • HtmlComponent
    • ViewComponent
    • CarouselComponent
    • ButtonComponent
    • TabComponent
    • ContainerComponent
    • SaveCustomPageComponent
    • SaveCustomPageData
    • ComponentConfig
    • SaveCustomPageRequest
    • app
    • CreateChartRequest
    • SaveCustomPageResponseData
    • CreateChartResponseData
    • ButtonItem
    • 基础返回对象
    • DimensionField
    • memberInfo
    • ValueField
    • department_with_path
    • SortField
    • departmentInfo
    • TimePointDynamic
    • regionInfo
    • process
    • process_detail
    • CustomDynamicRange
    • input
    • CustomRange
    • output
    • role
    • role_permission
    • optionset
    • field
    • CreateChartResponse
    • PageComponent
    • Position
    • filter_children
    • ErrorResponse
    • discussion
    • TabItem
    • SaveCustomPageResponse
    • User
    • WorkflowInputParameter
    • WorkflowOutputParameter
    • WorkflowNode
    • WorkflowValidationError
    • create_process_NodeRef
    • create_process_ValueRef
    • create_process_FieldValueRef
    • create_process_Filter
    • create_process_Condition
    • create_process_WorksheetEventTriggerConfig
    • create_process_ScheduleTriggerConfig
    • create_process_DateFieldTriggerConfig
    • create_process_WebhookTriggerConfig
    • create_process_TriggerSpec
    • batch_create_process_nodes_NodeRef
    • batch_create_process_nodes_ValueRef
    • batch_create_process_nodes_FieldValueRef
    • batch_create_process_nodes_RecordValueRef
    • batch_create_process_nodes_FieldPatch
    • batch_create_process_nodes_Filter
    • batch_create_process_nodes_Condition
    • batch_create_process_nodes_PersonRef
    • batch_create_process_nodes_AttachmentSpec
    • batch_create_process_nodes_FormProperty
    • batch_create_process_nodes_NodeSpec
    • batch_create_process_nodes_SortSpec
    • ApiResponseBase
    • WorkflowListType
    • WorkflowInstanceStatus
    • FlowNodeType
    • InstanceLogStatus
    • WorkItemOperationType
    • WorkItemLogAction
    • ApprovalAuthType
    • BatchRuleType
    • CallbackType
    • TriggerType
    • AppType
    • ApprovalResultBranchType
    • FailureCause
    • SignatureType
    • AppBrief
    • UserBrief
    • ControlValue
    • FlowNodeAuth
    • SelectNodeObject
    • FlowNode
    • InstanceLog
    • ProcessBrief
    • FileInfo
    • Signature
    • WorkItem
    • WorkItemLog
    • ChangedField
    • WorkflowInstance
    • BatchApprovalRequest
    • BatchApprovalInstance
    • BatchApprovalResult
    • OpinionRequest
    • ReturnRequest
    • bundled_2af3dc97c2fe
    • bundled_da9b1112b2d5
    • bundled_66310009f584
    • custom_page
    • worksheet
    • filter
    • record_row
  1. 自定义页面

更新自定义页面

正式环境
https://api.mingdao.com
正式环境
https://api.mingdao.com
PUT
/v3/app/custom-pages/{page_id}
更新(创建或全量覆盖)自定义页面的组件列表。页面采用 48 列栅格布局。提交后页面上的全部已有组件会被本次传入的列表替换。
支持的 componentType:chart(统计图)、section(分段标题)、text(富文本)、html(外链 iframe)、view(工作表视图)、carousel(轮播图)、button(按钮组,仅 action=1~4 简单动作)、tab(标签页容器)、container(卡片容器)、filtersGroup(筛选器)。不支持的 componentType:image(需先上传附件)、ai。
布局规则:并排在同一 y 坐标的组件必须同高(h 相同),否则矮组件下方会留空白。若自定义页面尚无配置,系统会自动应用默认页面配置(webNewCols=48)。
容器嵌套:tab / container 是父容器;它们自身的 UUID 写在顶层 componentId(调用方生成,本次请求内全局唯一)。挂到 container 下的子组件顶层传 parentSectionId = 该 container 的 componentId;挂到 tab 下的子组件顶层传 parentTabId = 目标 config.tabs[].tabId(tabId 也在本次请求内全局唯一)。parentSectionId 与 parentTabId 最多填一个。仅支持一层嵌套,tab/container 本身不能再挂到其它容器下。容器子组件的 position.x/y/w/h 以容器内部为原点的 48 列栅格。

请求参数

Authorization
Path 参数

Header 参数

Body 参数application/json

示例
{
    "components": [
        {
            "componentType": "chart",
            "name": "string",
            "componentId": "string",
            "parentSectionId": "string",
            "parentTabId": "string",
            "position": {
                "x": 0,
                "y": 0,
                "w": 0,
                "h": 0
            },
            "config": {
                "title": "string",
                "content": "string",
                "url": "string",
                "worksheetId": "string",
                "viewId": "string",
                "objectId": "string",
                "chartType": "string",
                "dataScope": "string",
                "timeFieldId": "string",
                "timeRange": "string",
                "customDynamicRange": {
                    "from": {
                        "type": "string",
                        "value": 0,
                        "unit": "string"
                    },
                    "to": {
                        "type": "string",
                        "value": 0,
                        "unit": "string"
                    }
                },
                "customRange": {
                    "startDate": "string",
                    "endDate": "string"
                },
                "dimension": [
                    {
                        "field": "string",
                        "granularity": 0,
                        "includeEmpty": true
                    }
                ],
                "rows": [
                    {
                        "field": "string"
                    }
                ],
                "columns": [
                    {
                        "field": "string"
                    }
                ],
                "values": [
                    {
                        "field": "string",
                        "aggregation": "string",
                        "displayName": "string"
                    }
                ],
                "rightValues": [
                    {
                        "field": "string",
                        "aggregation": "string"
                    }
                ],
                "targetValues": [
                    {
                        "field": "string",
                        "aggregation": "string"
                    }
                ],
                "gaugeMin": "string",
                "gaugeMax": "string",
                "mapScope": "country",
                "mapRegionCode": "string",
                "filtersGroupId": "string",
                "name": "string",
                "enableBtn": true,
                "filters": [
                    {
                        "filterId": "string",
                        "name": "string",
                        "global": true,
                        "dataType": 0,
                        "filterType": 0,
                        "objectControls": [
                            {
                                "objectId": "string",
                                "type": 0,
                                "worksheetId": "string",
                                "controlId": "string"
                            }
                        ],
                        "advancedSetting": {},
                        "values": [
                            "string"
                        ],
                        "value": "string",
                        "minValue": "string",
                        "maxValue": "string",
                        "controlId": "string"
                    }
                ],
                "appId": "string",
                "customPageId": "string",
                "filter": {
                    "type": "group",
                    "logic": "AND",
                    "children": [
                        {}
                    ],
                    "field": "string",
                    "operator": "eq",
                    "value": "string"
                },
                "sorts": [
                    {
                        "field": "string",
                        "isAsc": true
                    }
                ],
                "limit": 0,
                "image": "string",
                "subTitle": "string",
                "count": 0,
                "action": 0,
                "openMode": 0,
                "explain": "string",
                "style": 0,
                "width": 0,
                "mobileCount": 0,
                "buttons": [
                    {
                        "name": "string",
                        "action": 0,
                        "value": "string",
                        "viewId": "string",
                        "openMode": 0,
                        "color": "string",
                        "icon": "string"
                    }
                ],
                "tabs": [
                    {
                        "tabId": "string",
                        "name": "string"
                    }
                ],
                "showName": true,
                "showType": 0,
                "showBorder": true,
                "heightType": 0
            }
        }
    ]
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request PUT 'https://api.mingdao.com/v3/app/custom-pages/' \
--header 'HAP-Appkey: {{appkey}}' \
--header 'HAP-Sign: {{sign}}' \
--header 'Content-Type: application/json' \
--data '{
    "components": [
        {
            "componentType": "chart",
            "name": "string",
            "componentId": "string",
            "parentSectionId": "string",
            "parentTabId": "string",
            "position": {
                "x": 0,
                "y": 0,
                "w": 0,
                "h": 0
            },
            "config": {
                "title": "string",
                "content": "string",
                "url": "string",
                "worksheetId": "string",
                "viewId": "string",
                "objectId": "string",
                "chartType": "string",
                "dataScope": "string",
                "timeFieldId": "string",
                "timeRange": "string",
                "customDynamicRange": {
                    "from": {
                        "type": "string",
                        "value": 0,
                        "unit": "string"
                    },
                    "to": {
                        "type": "string",
                        "value": 0,
                        "unit": "string"
                    }
                },
                "customRange": {
                    "startDate": "string",
                    "endDate": "string"
                },
                "dimension": [
                    {
                        "field": "string",
                        "granularity": 0,
                        "includeEmpty": true
                    }
                ],
                "rows": [
                    {
                        "field": "string"
                    }
                ],
                "columns": [
                    {
                        "field": "string"
                    }
                ],
                "values": [
                    {
                        "field": "string",
                        "aggregation": "string",
                        "displayName": "string"
                    }
                ],
                "rightValues": [
                    {
                        "field": "string",
                        "aggregation": "string"
                    }
                ],
                "targetValues": [
                    {
                        "field": "string",
                        "aggregation": "string"
                    }
                ],
                "gaugeMin": "string",
                "gaugeMax": "string",
                "mapScope": "country",
                "mapRegionCode": "string",
                "filtersGroupId": "string",
                "name": "string",
                "enableBtn": true,
                "filters": [
                    {
                        "filterId": "string",
                        "name": "string",
                        "global": true,
                        "dataType": 0,
                        "filterType": 0,
                        "objectControls": [
                            {
                                "objectId": "string",
                                "type": 0,
                                "worksheetId": "string",
                                "controlId": "string"
                            }
                        ],
                        "advancedSetting": {},
                        "values": [
                            "string"
                        ],
                        "value": "string",
                        "minValue": "string",
                        "maxValue": "string",
                        "controlId": "string"
                    }
                ],
                "appId": "string",
                "customPageId": "string",
                "filter": {
                    "type": "group",
                    "logic": "AND",
                    "children": [
                        {}
                    ],
                    "field": "string",
                    "operator": "eq",
                    "value": "string"
                },
                "sorts": [
                    {
                        "field": "string",
                        "isAsc": true
                    }
                ],
                "limit": 0,
                "image": "string",
                "subTitle": "string",
                "count": 0,
                "action": 0,
                "openMode": 0,
                "explain": "string",
                "style": 0,
                "width": 0,
                "mobileCount": 0,
                "buttons": [
                    {
                        "name": "string",
                        "action": 0,
                        "value": "string",
                        "viewId": "string",
                        "openMode": 0,
                        "color": "string",
                        "icon": "string"
                    }
                ],
                "tabs": [
                    {
                        "tabId": "string",
                        "name": "string"
                    }
                ],
                "showName": true,
                "showType": 0,
                "showBorder": true,
                "heightType": 0
            }
        }
    ]
}'

返回响应

🟢200成功
application/json
保存成功
Bodyapplication/json

示例
{
    "success": true,
    "data": {
        "page_id": "page_001",
        "components": [
            {
                "componentId": "6800aa..."
            },
            {
                "componentId": "6800bb..."
            }
        ]
    }
}
🟠400请求有误
🟠403禁止访问
修改于 2026-06-25 10:21:03
上一页
根据行记录获取审批流程执行列表
下一页
获取选项集列表
Built with