批量更新数据

PUT

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

在数据仓库的指定表格中，根据指定的依据字段，找到一条数据后，用其他字段更新数据，单次最多批量处理 100 条数据。
如果更新模式为“upsert”，则会在没有找到数据时，使用全部字段创建新数据。
如果找到多条数据，则不会执行更新，同时会返回失败数据。创建或更新字段时，如果提供了系统字段，如 item_id 则仅可用作更新的依据字段，不会用来更新或创建数据。
仅支持操作 ext 类型的大数据表，可到企业账户页面中确认拥有“大数据表总量”资源时，可联系客户经理协助创建 ext 类型的大数据表。
注意：该接口为异步调用，将通过回调事件推送执行结果，详见”订阅回调事件“。

请求参数

Header 参数

Body 参数application/json

示例

{
    "table_id": "{{EXT_TABLE_ID}}",
    "update_type": "update",
    "update_by_fields":[
        "2200000137810772",
        "2200000137811680"
    ],
    "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/dw_item' \
--header 'Open-Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "table_id": "{{EXT_TABLE_ID}}",
    "update_type": "update",
    "update_by_fields":[
        "2200000137810772",
        "2200000137811680"
    ],
    "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": "1655712384374428"
    }
}

修改于 2025-04-24 01:03:20

批量创建数据

根据数据ID列表更新成相同数据