- 开发指南
- 工作区
- 表格数据
- 数据仓库数据
- 流程
- 文件
- 订阅
- 服务商
批量更新数据
PUT
https://api.huoban.com/openapi/v1/dw_item
如果更新模式为“upsert”,则会在没有找到数据时,使用全部字段创建新数据。
如果找到多条数据,则不会执行更新,同时会返回失败数据。创建或更新字段时,如果提供了系统字段,如 item_id 则仅可用作更新的依据字段,不会用来更新或创建数据。
仅支持操作 ext 类型的大数据表,可到企业账户页面中确认拥有“大数据表总量”资源时,可联系客户经理协助创建 ext 类型的大数据表。
注意:该接口为异步调用,将通过回调事件推送执行结果,详见”订阅回调事件“。
请求参数
Header 参数
Open-Authorization
string
必需
默认值:
Bearer {{API_KEY}}
Body 参数application/json
table_id
string
表格ID
update_type
string
更新模式
update_by_fields
array[string]
更新依赖字段
items
array [object {2}]
数据
item_id
string | null
数据ID
fields
object (字段提交)
字段值
示例
{
"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
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
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
integer
错误码
message
string
错误信息
data
object
返回数据
meta
object
元数据
trace_id
string
请求ID
示例
{
"code": 0,
"message": "success",
"data": {},
"meta": {
"trace_id": "1655712384374428"
}
}