4. 接口-更新记录（api-update-records/）

1. 接口地址

接口请求域名：https://api.vika.cn 请求方法：PATCH

PATCH /datasheets/{datasheetId}/records

2. 接口描述

更新某个维格表的若干条记录。

单次请求最多可更新 10 条记录。

在Request Header中需带上 Content-Type：application/json ，以 json 的格式提交数据。

对象 fields 包含一条记录中要新建的字段值，使用 PATCH 方法提交，只有显式指定的字段会更新数据，没有被指定的字段会保留旧值。

如果需要清空某字段的值，请设置为 null ，例如 "状态": null 。

3. 输入参数说明

4. 示例

示例1：更新维格表（ ID 为 dstWUHwzTHd2YQaXEE）指定的 2 条记录（ recordId 为 recbaKEuZ9gDC和rec09dm5nsmS6 ）。

请求示例（cURL）：

curl -X PATCH \
  https://api.vika.cn/fusion/v1/datasheets/dstWUHwzTHd2YQaXEE/records \
  -H 'Authorization: Bearer {你的 API Token}' \
  -H 'Content-Type: application/json' \
  -d '{
    "records": [
        {
            "recordId": "recbaKEuZ9gDC",
            "fields": {
                "昵称": "安安",
                "体重": "90公斤"
            }
        },
        {
            "recordId": "rec09dm5nsmS6",
            "fields": {
                "昵称": "佳佳",
                "体重": "89公斤"
            }
        }
    ]
}'

返回示例：

正常情况下，维格表服务端会返回下述 JSON 数据包。调用成功后，会完整返回更新后的记录数据。

{
    "code": 200,
    "success": true,
    "data": {
        "records": [
            {
                "recordId": "recbaKEuZ9gDC",
                "createdAt": 1600431195000,
                "fields": {
                    "体重": "90公斤",
                    "肩高": "65厘米",
                    "登记日期": "2020/09/15 17:14",
                    "胸围": "87厘米",
                    "体长": "1.2米",
                    "拍照": [
                        {
                            "id": "atcPtxnvqti5M",
                            "name": "6.gif",
                            "size": 33914,
                            "mimeType": "image/gif",
                            "token": "space/2020/09/22/01ee7202922d48688f61e34f12da5abc",
                            "width": 240,
                            "height": 240,
                            "url": "https://s1.vika.cn/space/2020/09/22/01ee7202922d48688f61e34f12da5abc"
                        }
                    ],
                    "登记员": [
                        {
                            "unitId": "1286184164530659329",
                            "unitType": 3,
                            "unitName": "Bruce · K",
                            "avatar": "https://s1.vika.cn/public/2020/08/03/574bcee4cfc54f6fbb7d686bb237f6f3"
                        }
                    ],
                    "性别": "男孩",
                    "昵称": "安安",
                    "年龄": "5岁"
                }
            },
            {
                "recordId": "rec09dm5nsmS6",
                "createdAt": 1600431195000,
                "fields": {
                    "体重": "89公斤",
                    "肩高": "66厘米",
                    "登记日期": "2020/09/15 17:14",
                    "胸围": "89厘米",
                    "体长": "1.4米",
                    "拍照": [
                        {
                            "id": "atcPtxnvqti5M",
                            "name": "6.gif",
                            "size": 33914,
                            "mimeType": "image/gif",
                            "token": "space/2020/09/22/01ee7202922d48688f61e34f12da5abc",
                            "width": 240,
                            "height": 240,
                            "url": "https://s1.vika.cn/space/2020/09/22/01ee7202922d48688f61e34f12da5abc"
                        }
                    ],
                    "登记员": [
                        {
                            "unitId": "1291258301781176321",
                            "unitType": 3,
                            "unitName": "小葵🌻",
                            "avatar": "https://s1.vika.cn/public/2020/09/07/dbfe6ceccbdb4d5bbc1fd129566dea89"
                        }
                    ],
                    "性别": "女孩",
                    "昵称": "佳佳",
                    "年龄": "6岁"
                }
            }
        ]
    },
    "message": "SUCCESS"
}

返回对象说明：

Record Object 说明：