工作表记录
批量新增行记录
根据鉴权方式查看“批量新增行记录”对应的真实 API 地址、参数与响应。
鉴权方式
AppKey + Sign 是应用密钥鉴权，由管理员创建，用于以应用管理员身份访问应用数据。
版本
请求地址
Path 参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
worksheet_id | string | 是 | 工作表ID |
Header 参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
HAP-Appkey | string | 是 | HAP应用密钥 |
HAP-Sign | string | 是 | HAP签名 |
Body 参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
rows | object[] | 是 | 批量创建的记录数据 |
rows.fields | object[] | 是 | 字段列表 |
rows.fields.id | string | 是 | 字段ID/别名 |
rows.fields.value | string | 是 | 字段值 type=Attachment时示例传参：[{"name":"文件名称，带后缀","url":" url/base64"}] |
rows.fields.type | integer | 否 | type=SingleSelect/MultipleSelect 时， type=Attachment时 |
triggerWorkflow | boolean | 否 | 是否触发工作流 |
响应参数
200成功批量创建记录| 名称 | 类型 | 描述 |
|---|---|---|
success | boolean | 是否调用成功 |
error_code | integer | 错误代码 |
error_msg | string | 错误消息 |
data | object | 批量创建记录结果 |
data.rowIds | string[] | 成功创建的记录ID列表 |
curl -X POST "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 '{ "rows": [ { "fields": [ { "id": "field1", "value": "值1" }, { "id": "field2", "value": "值2" } ] }, { "fields": [ { "id": "field1", "value": "值3" }, { "id": "field2", "value": "值4" } ] } ], "triggerWorkflow": true }'{ "data": { "rowIds": [ "row1", "row2" ] }, "success": true}