创建表格

本文提供调用「创建表格」接口的操作示例。

示例：在维格云中创建表格

假设你有一个空间站，你想在空间站中创建一张表格。

你的操作步骤如下：

获取你的 API Token。（获取方法）
获取你的空间站 ID。（获取方法）
获取所属文件夹的 ID（非必填）。（获取方法）

打开你电脑上的终端，执行下列代码，向服务器发送查询请求（假设 spaceId 为 spcjXzqVrjaP3）：

cURL
Javascript SDK
Python SDK

curl -X POST \
"https://vika.cn/fusion/v1/spaces/spcjXzqVrjaP3/datasheets" \
-H "Authorization: Bearer {你的 API Token}" \
-H 'Content-Type: application/json' \
-d '{
 "name": "表格标题",
 "description": "表格描述",
 "folderId": "非必填，所属文件夹ID",
 "preNodeId": "非必填，前一个节点ID",
 "fields": [
   {
     "type": "Text",
     "name": "标题"
   }
 ]
}'

注意：需要先下载和初始化 Javascript SDK，再执行如下命令。

import { Vika } from '@vikadata/vika';

const vika = new Vika({
 token: '你的 API Token',
});

// 参照IAddOpenFieldProperty，不同FieldType对应到不同的Property结构
const property = {
 defaultValue: '我是默认值',
};

const fieldRo = {
 name: '新增文本字段',
 type: 'SingleText',
 property,
};

const datasheetRo = {
 name: '新建单测表格',
 fields: [fieldRo],
};

try {
 const res = await vika.space('spcjXzqVrjaP3').datasheets.create(datasheetRo);
 if (res.success) {
   for (const field of res.data.fields) {
     // TODO: save field.id
   }
 }
} catch (error) {
 // TODO: handle error
}

注意：需要先下载和初始化 Python SDK，再执行如下命令。

from vika import Vika

 token: '你的 API Token',

prop = {
    'defaultValue': '我是默认值'
}
field = {
    'name': '新增文本字段',
    'type': 'SingleText',
    'property': prop
}
req_data = {
    'name': '新建单测表格',
    'fields': [field]
}
try:
    datasheet = vika.space('spcjXzqVrjaP3').datasheets.create(req_data)
except Exception:
    # 处理异常情况
    pass

服务器会返回下列 JSON 数据包，"data" 下即为返回的新增表格信息：

有关返回结果中各参数的含义，可查看 API 手册。

{
  "success": true,
  "code": 200,
  "message": "SUCCESS",
  "data": {
    "id": "dstbs2U7mt8AEqgKuh",
    "createdAt": 1648648690000,
    "fields": [
      {
        "id": "fldupsvkR2ATB",
        "name": "标题"
      }
    ]
  }
}

示例：在维格云中创建表格​

示例：在维格云中创建表格