vika维格表 API
  1. 表格
vika维格表 API
  • 维格表 API 参考手册 (beta)
  • 常见问答 FAQ
  • Apifox × 维格表使用指南
  • 记录
    • 获取记录
      GET
    • 创建记录
      POST
    • 更新记录
      PATCH
    • 删除记录
      DELETE
  • 字段
    • 获取字段
      GET
    • 创建字段
      POST
    • 删除字段
      DELETE
  • 视图
    • 获取视图
      GET
  • 表格
    • 创建表格
      POST
  • 附件
    • 上传附件
      POST
  • 空间站
    • 获取空间站列表
      GET
  • 工作目录
    • 获取文件列表
      GET
    • 获取文件详情
      GET
  1. 表格

创建表格

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
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
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 
必需
id
string 
表格ID
必需
createdAt
integer 
创建时间戳
必需
fields
array [object {2}] 
必需
示例
{
  "success": true,
  "code": 0,
  "message": "string",
  "data": {
    "id": "string",
    "createdAt": 0,
    "fields": [
      {
        "id": "string",
        "name": "string"
      }
    ]
  }
}
上一页
获取视图
下一页
上传附件
Built with