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

新建工作表

正式环境
https://api.mingdao.com
正式环境
https://api.mingdao.com
POST
/v3/app/worksheets
创建工作表,目前支持字段类型有Text|Number|SingleSelect|MultipleSelect|Date|DateTime|Collaborator|Relation|Attachment

请求参数

Header 参数

Body 参数application/json

示例
{
    "name": "测试新建工作表",
    "sectionId": "",
    "fields": [
        {
            "name": "文本",
            "alias": "",
            "type": "Text",
            "required": true,
            "isTitle": 1
        },
        {
            "name": "数值",
            "alias": "",
            "type": "Number",
            "precision": 2,
            "required": true
        },
        {
            "name": "单选",
            "alias": "",
            "type": "SingleSelect",
            "options": [
                {
                    "value": "选项名称1",
                    "index": 1
                },
                {
                    "value": "选项名称2",
                    "index": 2
                }
            ],
            "required": true
        },
        {
            "name": "多选",
            "alias": "",
            "type": "MultipleSelect",
            "options": [
                {
                    "value": "选项名称1",
                    "index": 1
                },
                {
                    "value": "选项名称2",
                    "index": 2
                },
                {
                    "value": "选项名称3",
                    "index": 3
                }
            ],
            "required": true
        },
        {
            "name": "时间-时分",
            "alias": "",
            "type": "Time",
            "required": true,
            "subType": 1
        },
        {
            "name": "时间-时分秒",
            "alias": "",
            "type": "Time",
            "required": true,
            "subType": 6
        },
        {
            "name": "成员-单选",
            "type": "Collaborator",
            "alias": "",
            "subType": 0,
            "required": true
        },
        {
            "name": "成员-多选",
            "type": "Collaborator",
            "alias": "",
            "subType": 1,
            "required": true
        },
        {
            "name": "附件",
            "alias": "",
            "type": "Attachment",
            "required": true
        },
        {
            "name": "日期",
            "alias": "",
            "type": "Date",
            "subType": 5,
            "required": true
        },
        {
            "name": "时间",
            "alias": "",
            "type": "Date",
            "subType": 1,
            "required": true
        },
        {
            "name": "关联记录",
            "alias": "",
            "type": "Relation",
            "subType": 1,
            "relation": {
                "showFields": [],
                "bidirectional": true
            },
            "dataSource": "",
            "required": true
        }
    ]
}

请求示例代码

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/v3/app/worksheets' \
--header 'HAP-Appkey: {{appkey}}' \
--header 'HAP-Sign: {{sign}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "测试新建工作表",
    "sectionId": "",
    "fields": [
        {
            "name": "文本",
            "alias": "",
            "type": "Text",
            "required": true,
            "isTitle": 1
        },
        {
            "name": "数值",
            "alias": "",
            "type": "Number",
            "precision": 2,
            "required": true
        },
        {
            "name": "单选",
            "alias": "",
            "type": "SingleSelect",
            "options": [
                {
                    "value": "选项名称1",
                    "index": 1
                },
                {
                    "value": "选项名称2",
                    "index": 2
                }
            ],
            "required": true
        },
        {
            "name": "多选",
            "alias": "",
            "type": "MultipleSelect",
            "options": [
                {
                    "value": "选项名称1",
                    "index": 1
                },
                {
                    "value": "选项名称2",
                    "index": 2
                },
                {
                    "value": "选项名称3",
                    "index": 3
                }
            ],
            "required": true
        },
        {
            "name": "时间-时分",
            "alias": "",
            "type": "Time",
            "required": true,
            "subType": 1
        },
        {
            "name": "时间-时分秒",
            "alias": "",
            "type": "Time",
            "required": true,
            "subType": 6
        },
        {
            "name": "成员-单选",
            "type": "Collaborator",
            "alias": "",
            "subType": 0,
            "required": true
        },
        {
            "name": "成员-多选",
            "type": "Collaborator",
            "alias": "",
            "subType": 1,
            "required": true
        },
        {
            "name": "附件",
            "alias": "",
            "type": "Attachment",
            "required": true
        },
        {
            "name": "日期",
            "alias": "",
            "type": "Date",
            "subType": 5,
            "required": true
        },
        {
            "name": "时间",
            "alias": "",
            "type": "Date",
            "subType": 1,
            "required": true
        },
        {
            "name": "关联记录",
            "alias": "",
            "type": "Relation",
            "subType": 1,
            "relation": {
                "showFields": [],
                "bidirectional": true
            },
            "dataSource": "",
            "required": true
        }
    ]
}'

返回响应

🟢200成功
application/json
Body

示例
{
    "data": {
        "worksheetId": ""
    },
    "success": true
}
修改于 2025-09-08 03:21:43
上一页
删除工作表
下一页
获取行记录列表
Built with