工作表记录
批量更新行记录详情
根据鉴权方式查看“批量更新行记录详情”对应的真实 API 地址、参数与响应。
鉴权方式
AppKey + Sign 是应用密钥鉴权，由管理员创建，用于以应用管理员身份访问应用数据。
版本
请求地址
Path 参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
worksheet_id | string | 是 | 工作表ID |
Header 参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
HAP-Appkey | string | 是 | HAP应用密钥 |
HAP-Sign | string | 是 | HAP签名 |
Body 参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
rowIds | string[] | 是 | 要更新的记录ID列表 |
fields | object[] | 是 | 要更新的字段列表，会应用到所有指定的记录上 |
fields.id | string | 是 | 字段 id |
fields.value | any | 是 | 字段值 type=Attachment时示例传参： |
fields.type | integer | 否 | type=SingleSelect/MultipleSelect 时， type=Attachment时 |
triggerWorkflow | boolean | 否 | 是否触发工作流 |
响应参数
200成功批量更新记录| 名称 | 类型 | 描述 |
|---|---|---|
success | boolean | 是否调用成功 |
error_code | integer | 错误代码 |
error_msg | string | 错误消息 |
data | object | 批量更新记录结果 |
data.failedRowIds | string[] | 失败的记录ID列表 |
data.successfulRowIds | string[] | 成功更新的记录ID列表 |
curl -X PATCH "https://example.com/v3/app/worksheets/worksheet_id/rows/batch" \ -H "HAP-Appkey: {{HAP-Appkey}}" \ -H "HAP-Sign: {{HAP-Sign}}" \ -H "Content-Type: application/json" \ -d '{ "rowIds": [ "row1", "row2" ], "fields": [ { "id": "field1", "value": "新值1" }, { "id": "field2", "value": "新值2" } ], "triggerWorkflow": true }'{ "data": { "failedRowIds": [], "successfulRowIds": [ "row1", "row2" ] }, "success": true}