创建字段

POST

/spaces/{spaceId}/datasheets/{datasheetId}/fields

字段

该接口用于在指定的维格表中创建新的字段。单张维格表最多创建 200 个字段。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Path 参数

spaceId

string

空间站 ID

必需

示例值:

spcNk6UFzhVsc

datasheetId

string

数表 ID

必需

示例值:

dstrZEytCvukCVee9G

Header 参数

Authorization

string

API Token

必需

默认值:

Bearer {{token}}

Body 参数application/json

type

string

字段类型

必需

name

string

必需

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

property

object | null

根据字段类型设置

必需

示例

{
  "type": "SingleText",
  "name": "标题",
  "property": {
    "defaultValue": "默认文本文本"
  }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.vika.cn/fusion/v1/spaces/spcNk6UFzhVsc/datasheets/dstrZEytCvukCVee9G/fields' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
  "type": "SingleText",
  "name": "标题",
  "property": {
    "defaultValue": "默认文本文本"
  }
}'

返回响应

🟢200成功

application/json

Body

success

boolean

必需

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

code

integer

必需

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

message

string

必需

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

data

object

必需

string

字段ID

必需

name

string

字段名称

必需

示例

{
  "success": true,
  "code": 0,
  "message": "string",
  "data": {
    "id": "string",
    "name": "string"
  }
}

获取字段

删除字段