创建表格

POST

/spaces/{spaceId}/datasheets

表格

该接口用于在指定的空间站中创建含指定字段的维格表。单次请求最多可以在新建的维格表中创建 200 个字段。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

spaceId

string

空间站 ID

必需

示例值:

spcjXzqVrjaP3

Header 参数

Authorization

string

API Token

必需

默认值:

Bearer {{token}}

Body 参数application/json

name

string

必需

表格名称，不能多于100个字符

description

string

必需

表格描述，不能多于500个字符

folderId

string | null

必需

所属文件夹ID，为空则默认为工作目录

preNodeId

string | null

必需

前一个节点ID，为空则移到首位

fields

array [object {3}]

必需

字段列表，为空则新增3列默认字段

type

string

字段类型

必需

name

string

必需

字段名称, 不能多于100个字符

property

string

可选

根据字段类型设置相关的参数

示例

{
  "name": "string",
  "description": "string",
  "folderId": "string",
  "preNodeId": "string",
  "fields": [
    {
      "type": "string",
      "name": "string",
      "property": "string"
    }
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.vika.cn/fusion/v1/spaces/spcjXzqVrjaP3/datasheets' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "string",
    "description": "string",
    "folderId": "string",
    "preNodeId": "string",
    "fields": [
        {
            "type": "string",
            "name": "string",
            "property": "string"
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

success

boolean

必需

全局状态值，如果为 false，则表示发生了业务错误或接口调用错误。

code

integer

必需

业务状态码，200 表示业务请求成功。

message

string

必需

返回信息，执行错误时返回错误信息。

data

object

必需

string

表格ID

必需

createdAt

integer

创建时间戳

必需

fields

array [object {2}]

必需

示例

{
  "success": true,
  "code": 0,
  "message": "string",
  "data": {
    "id": "string",
    "createdAt": 0,
    "fields": [
      {
        "id": "string",
        "name": "string"
      }
    ]
  }
}

修改于 2022-10-26 02:56:25

获取视图

上传附件