工作表记录
更新行记录
根据鉴权方式查看“更新行记录”对应的真实 API 地址、参数与响应。
鉴权方式
AppKey + Sign 是应用密钥鉴权，由管理员创建，用于以应用管理员身份访问应用数据。
版本
请求地址
Path 参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
worksheet_id | string | 是 | 工作表ID |
row_id | string | 是 | 行记录ID |
Header 参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
HAP-Appkey | string | 是 | HAP应用密钥 |
HAP-Sign | string | 是 | HAP签名 |
Body 参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
fields | object[] | 是 | 字段列表 |
fields.id | string | 是 | 字段 id |
fields.value | any | 是 | 字段值 type=Attachment时示例传参： |
fields.updateType | string | 否 | 字段值更新类型（新增时不用传），默认为 0 • 0=覆盖 • 1=新增 • 2=减少（Attachment 附件类型时，value 里直接传文件 ID，不存在则移除失败） 适用字段类型：Attachment 附件｜MultipleSelect 多选｜Collaborator 成员｜Department 部门｜Relation 关联｜SubTable 子表｜OrgRole 组织角色 可选值： "0""1""2" |
fields.allowNewOptions | boolean | 否 | 当选择值不在选项范围内时，是否允许新增选项 • true：允许增加选项 • false：不增加选项 适用字段类型：SingleSelect 单选｜MultipleSelect 多选 |
triggerWorkflow | boolean | 否 | 是否触发工作流 |
响应参数
200成功更新记录| 名称 | 类型 | 描述 |
|---|---|---|
success | boolean | 是否调用成功 |
error_code | integer | 错误代码 |
error_msg | string | 错误消息 |
data | object | — |
data.id | string | 行记录ID |
curl -X PATCH "https://example.com/v3/app/worksheets/worksheet_id/rows/row_id" \ -H "HAP-Appkey: {{HAP-Appkey}}" \ -H "HAP-Sign: {{HAP-Sign}}" \ -H "Content-Type: application/json" \ -d '{ "fields": [ { "id": "6847f2a1e66b4b2aa67b1467", "value": "更新后的值" } ], "triggerWorkflow": true }'{ "success": true, "data": { "id": "89d4fd5b-91d8-4b0d-babc-263cefed16c7" }}