批量更新或创建数据

PUT

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

根据指定的依据字段，找到一条数据后，用其他字段更新数据，单次最多批量处理 100 条数据。
如果更新模式为“upsert”，则会在没有找到数据时，使用全部字段创建新数据。
如果找到多条数据，则不会执行更新。
创建或更新数据时，如果提供了系统字段，如“item_id”，则仅可用作更新的依据字段，不会用来更新或创建数据。
注意：该接口为异步调用，将通过回调事件推送执行结果，详见”订阅回调事件“。

请求参数

Header 参数

Body 参数application/json

示例

{
    "table_id": "{{TABLE_ID}}",
    "update_type": "upsert",
    "update_by_fields" : [
        "item_id"
    ],
    "items": [
        {
            "item_id": "2300002213303374",
            "fields": {
                "2200000137810772": "单行文本101",
                "2200000137811680": "多行文本1\n多行文本1\n多行文本1"
            }
        },
        {
            "item_id": "2300002213303371",
            "fields": {
                "2200000137810772": "单行文本102",
                "2200000137811680": "多行文本2\n多行文本2\n多行文本2"
            }
        },
        {
            "item_id": "2300002213303372",
            "fields": {
                "2200000137810772": "单行文本103",
                "2200000137811680": "多行文本3\n多行文本3\n多行文本3"
            }
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT 'https://api.huoban.com/openapi/v1/items' \
--header 'Open-Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "table_id": "",
    "update_type": "upsert",
    "update_by_fields" : [
        "item_id"
    ],
    "items": [
        {
            "item_id": "2300002213303374",
            "fields": {
                "2200000137810772": "单行文本101",
                "2200000137811680": "多行文本1\n多行文本1\n多行文本1"
            }
        },
        {
            "item_id": "2300002213303371",
            "fields": {
                "2200000137810772": "单行文本102",
                "2200000137811680": "多行文本2\n多行文本2\n多行文本2"
            }
        },
        {
            "item_id": "2300002213303372",
            "fields": {
                "2200000137810772": "单行文本103",
                "2200000137811680": "多行文本3\n多行文本3\n多行文本3"
            }
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "code": 0,
    "message": "success",
    "data": {},
    "meta": {
        "trace_id": "1677728211249166"
    },
    "version": "v1.0.1"
}

修改于 2025-04-24 01:01:23

批量创建数据

批量删除数据