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

新建工作表

正式环境
https://api.mingdao.com
正式环境
https://api.mingdao.com
POST
/v3/app/worksheets
创建工作表,目前支持字段类型有Text|RichText|Number|Currency|SingleSelect|MultipleSelect|Dropdown|Date|DateTime|Time|Collaborator|Department|Role|Rating|Checkbox|PhoneNumber|LandlinePhone|Email|Location|Region|Formula|DateFormula|AutoNumber|Relation|Divider|Attachment

请求参数

Header 参数

Body 参数application/json

示例
{
  "appId": "2683eebd-34a5-41fd-a379-72cb608ee7fc",
  "name": "综合字段测试表",
  "alias": "combined_test",
  "fields": [
    // ==========================================
    // 文本类型 (Text) 测试
    // ==========================================
    {
      "name": "标题 (单行文本)",
      "alias": "title",
      "type": "Text",
      "description": "适用于简短的名字或标题",
      "config": {
        "textMode": "singleLine"
      }
    },
    {
      "name": "备注 (多行文本)",
      "alias": "remarks",
      "type": "Text",
      "description": "适用于长段落的纯文本输入",
      "config": {
        "textMode": "multiLine"
      }
    },
    {
      "name": "详细说明 (Markdown)",
      "alias": "description_md",
      "type": "Text",
      "description": "支持 Markdown 语法的富文本排版",
      "config": {
        "textMode": "markdown"
      }
    },
    
    // ==========================================
    // 基础时间字段 (作为 DateFormula 的引用来源)
    // ==========================================
    {
      "name": "开始时间",
      "alias": "start_time",
      "type": "DateTime",
      "config": {
        "format": "YYYY-MM-DD HH:mm"
      }
    },
    {
      "name": "结束时间",
      "alias": "end_time",
      "type": "DateTime",
      "config": {
        "format": "YYYY-MM-DD HH:mm"
      }
    },
    {
      "name": "偏移量(天)",
      "alias": "offset_days",
      "type": "Number",
      "config": {
        "precision": 0
      }
    },
    
    // ==========================================
    // 日期公式 (DateFormula) 测试
    // ==========================================
    {
      "name": "工时计算 (dateDiff)",
      "alias": "work_hours",
      "type": "DateFormula",
      "description": "计算结束时间与开始时间的差值,单位为小时",
      "config": {
        "formulaType": "dateDiff",
        "startTime": {
          "source": "field",
          "field": "start_time"
        },
        "endTime": {
          "source": "field",
          "field": "end_time"
        },
        "outputUnit": "h",
        "precision": 1
      }
    },
    {
      "name": "预计完成时间 (dateOffset)",
      "alias": "expected_finish_time",
      "type": "DateFormula",
      "description": "基于开始时间加上数值字段指定的偏移天数",
      "config": {
        "formulaType": "dateOffset",
        "targetTime": {
          "source": "field",
          "field": "start_time"
        },
        "offset": "+$offset_days$d"
      }
    },
    {
      "name": "距离结束还有几天 (dateNowDiff)",
      "alias": "days_remaining",
      "type": "DateFormula",
      "description": "目标时间减去当前时刻",
      "config": {
        "formulaType": "dateNowDiff",
        "targetTime": {
          "source": "field",
          "field": "end_time"
        },
        "direction": "targetMinusNow",
        "outputUnit": "d",
        "precision": 0
      }
    }
  ]
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://api.mingdao.com/v3/app/worksheets' \
--header 'HAP-Appkey: bb185b7d216a1714' \
--header 'HAP-Sign: YzhkZjBkYWEwNzQ2NmU3ODEzN2I4YjhhYWQzZGUwODg1YTY3YWJiOTBjODI2ODJlM2RhOGU2Nzk1ZTIxZTA3Zg==' \
--header 'Content-Type: application/json' \
--data '{
  "appId": "2683eebd-34a5-41fd-a379-72cb608ee7fc",
  "name": "综合字段测试表",
  "alias": "combined_test",
  "fields": [
    // ==========================================
    // 文本类型 (Text) 测试
    // ==========================================
    {
      "name": "标题 (单行文本)",
      "alias": "title",
      "type": "Text",
      "description": "适用于简短的名字或标题",
      "config": {
        "textMode": "singleLine"
      }
    },
    {
      "name": "备注 (多行文本)",
      "alias": "remarks",
      "type": "Text",
      "description": "适用于长段落的纯文本输入",
      "config": {
        "textMode": "multiLine"
      }
    },
    {
      "name": "详细说明 (Markdown)",
      "alias": "description_md",
      "type": "Text",
      "description": "支持 Markdown 语法的富文本排版",
      "config": {
        "textMode": "markdown"
      }
    },
    
    // ==========================================
    // 基础时间字段 (作为 DateFormula 的引用来源)
    // ==========================================
    {
      "name": "开始时间",
      "alias": "start_time",
      "type": "DateTime",
      "config": {
        "format": "YYYY-MM-DD HH:mm"
      }
    },
    {
      "name": "结束时间",
      "alias": "end_time",
      "type": "DateTime",
      "config": {
        "format": "YYYY-MM-DD HH:mm"
      }
    },
    {
      "name": "偏移量(天)",
      "alias": "offset_days",
      "type": "Number",
      "config": {
        "precision": 0
      }
    },
    
    // ==========================================
    // 日期公式 (DateFormula) 测试
    // ==========================================
    {
      "name": "工时计算 (dateDiff)",
      "alias": "work_hours",
      "type": "DateFormula",
      "description": "计算结束时间与开始时间的差值,单位为小时",
      "config": {
        "formulaType": "dateDiff",
        "startTime": {
          "source": "field",
          "field": "start_time"
        },
        "endTime": {
          "source": "field",
          "field": "end_time"
        },
        "outputUnit": "h",
        "precision": 1
      }
    },
    {
      "name": "预计完成时间 (dateOffset)",
      "alias": "expected_finish_time",
      "type": "DateFormula",
      "description": "基于开始时间加上数值字段指定的偏移天数",
      "config": {
        "formulaType": "dateOffset",
        "targetTime": {
          "source": "field",
          "field": "start_time"
        },
        "offset": "+$offset_days$d"
      }
    },
    {
      "name": "距离结束还有几天 (dateNowDiff)",
      "alias": "days_remaining",
      "type": "DateFormula",
      "description": "目标时间减去当前时刻",
      "config": {
        "formulaType": "dateNowDiff",
        "targetTime": {
          "source": "field",
          "field": "end_time"
        },
        "direction": "targetMinusNow",
        "outputUnit": "d",
        "precision": 0
      }
    }
  ]
}'

返回响应

🟢200成功
application/json
成功创建工作表
Bodyapplication/json

示例
{
    "data": {
        "worksheetId": "worksheet123"
    },
    "success": true
}
修改于 2026-05-19 07:50:34
上一页
获取工作表列表
下一页
获取工作表结构信息
Built with