批量更新或创建数据
/openapi/v1/items
根据指定的依据字段,找到一条数据后,用其他字段更新数据,单次最多批量处理 100 条数据。
如果更新模式为“upsert”,则会在没有找到数据时,使用全部字段创建新数据。
如果找到多条数据,则不会执行更新。
创建或更新数据时,如果提供了系统字段,如“item_id”,则仅可用作更新的依据字段,不会用来更新或创建数据。
注意:该接口为异步调用,将通过回调事件推送执行结果,详见”订阅回调事件“。
请求参数
Body 参数application/json
table_id
string
表格ID
update_type
string
更新模式
枚举值:
updateupsert
update_by_fields
array[string]
更新依据字段
可指定多个更新依据的系统字段和自定义字段的 ID 列表,进行联合唯一判断,如填写了“item_id”则会忽略传入的其他字段,仅使用“item_id”作为更新依据
items
array [object {2}]
数据
更新或创建的数据列表
item_id
string
数据ID
如在“更新依据字段”中指定了 item_id 则必须提供,仅用作更新数据的依据字段
fields
object {0}
字段值
如在“更新依据字段”中指定了对应的字段则必须提供该字段及值
示例
{
"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"
}
}
]
}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSON
数据结构
object {0}
示例
{
"code": 0,
"message": "success",
"data": {},
"meta": {
"trace_id": "1677728211249166"
},
"version": "v1.0.1"
}
修改时间 5 个月前