批量创建数据

POST

https://api.huoban.com/openapi/v1/items

在指定表格中创建新数据，支持传入数据的数组做批量创建，单次最多批量创建 100 条数据。
注意：该接口为异步调用，将通过回调事件推送执行结果，详见”订阅回调事件“。

请求参数

Header 参数

Open-Authorization

string

必需

授权的 API Key

默认值:

Bearer {{API_KEY}}

Body 参数application/json

table_id

string

表格ID

必需

items

array[object (字段提交) {1}]

数据

必需

{field_id}

必需

只枚举出需要提交的字段，Key为字段ID，并根据字段的数据类型（data_type）提交对应类型的字段值

callback_field_ids

array[string]

结果回调回传字段

可选

如果配置了该值，则回调结果中会返回配置的字段的值，最多设置3个字段ID

<= 3 items

示例

{
  "table_id": "{{TABLE_ID}}",
  "items": [
    {
      "2200000137810772": "单行文本1",
      "2200000137811680": "多行文本1\n多行文本1\n多行文本1"
    },
    {
      "2200000137810772": "单行文本2",
      "2200000137811680": "多行文本2\n多行文本2\n多行文本2"
    },
    {
      "2200000137810772": "单行文本3",
      "2200000137811680": "多行文本3\n多行文本3\n多行文本3"
    }
  ],
  "callback_field_ids": [
    "2200000137810772"
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.huoban.com/openapi/v1/items' \
--header 'Open-Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "table_id": "",
    "items": [
        {
            "2200000137810772": "单行文本1",
            "2200000137811680": "多行文本1\n多行文本1\n多行文本1"
        },
        {
            "2200000137810772": "单行文本2",
            "2200000137811680": "多行文本2\n多行文本2\n多行文本2"
        },
        {
            "2200000137810772": "单行文本3",
            "2200000137811680": "多行文本3\n多行文本3\n多行文本3"
        }
    ],
    "callback_field_ids":["2200000137810772"]
}'

返回响应

🟢200成功

application/json

Body

code

integer

错误码

必需

0 为成功，小于 10000 为系统异常，其他为业务异常

message

string

错误信息

必需

具体的错误原因，code 为 0 时返回“success”

data

object

返回数据

必需

返回具体数据的结构

items

array [object {1}]

数据列表

必需