修改数据

Ragic支持使用POST、PUT、PATCH请求来修改数据。 修改数据的端点与读现有数据的端点相同。请注意，当您创建数据时，端点指向一个 Ragic 表单，但当您编辑数据时，您的端点将需要额外的数据 ID 来指向确切的一笔数据。

https://www.ragic.com////?api

您只需提供要修改的字段 ID。如果字段是日期字段，则其值需要使用 yyyy/MM/dd 或 yyyy/MM/dd HH:mm 格式。

curl -F "2000123=Dunder Mifflin" \
 -F "2000127=Jim Halpert" \
 -F "api=" \
 -H "Authorization:Basic YOUR_API_KEY_GOES_HERE" \
 https://www.ragic.com/demo/sales/1/3

相应的 JSON 格式如下：

{
    "2000123": "Dunder Mifflin", 
    "2000127": "Jim Halpert" 
}

对于子表格来说，稍微复杂一些。因为 Ragic 需要知道您正在编辑的列。因此，您需要找到要编辑的列的 ID。此信息可以从 API 调用中获取。

如前面章节所述，带有子表格数据的回传格式如下：

"_subtable_2000154": {
    "0": {
      "Contact Name": "Jeff Kuo",
      "Title": "Technical Manager",
      "Phone": "886-668-037",
      "E-mail": "jeff@ragic.com",
...
...
    },
    "1": {
      "Contact Name": "Amy Tsai",
      "Title": "Marketing",
      "Phone": "",
...
...
    },
    "2": {
      "Contact Name": "Allie Lin",
      "Title": "Purchasing",
...
...

在子表格中，1是联络人 Amy Tsai 的列 ID，2是联络人 Allie Lin 的列 ID。使用这些列 ID，就可以针对该子表格列修改数据。

您可以使用列 ID 作为跟随在字段 ID 之后的标识符号。并放入要修改的字段：

2000147_1=Ms. Amy Tsai
2000148_1=Senior Specialist

2000148_2=Senior Manager

整个请求将如下所示：

curl -F "2000123=Dunder Mifflin" \
 -F "2000127=Jim Halpert" \
 -F "2000147_1=Ms. Amy Tsai" \
 -F "2000148_1=Senior Specialist" \
 -F "2000148_2=Senior Manager" \
 -F "api=" \
 -H "Authorization:Basic YOUR_API_KEY_GOES_HERE" \
 https://www.ragic.com/demo/sales/1/3

相应的 JSON 格式如下：

{
    "2000123": "Dwight Schrute", 
    "2000127": "Jim Halpert" ,
    "_subtable_2000154": {
        "29" :{
            "2000147": "Ms. Amy Tsai",
            "2000148": "Senior Specialist"
        },
        "30" :{
            "2000148": "Senior Manager"
        } 
    }
}

如果要删除子表格列，可以创建如下请求：

DELSUB_=

相应的 JSON 格式如下：

_DELSUB_=[,,...,];

例如，如果要删除联络人 Arden Jacobs，整个请求如下所示：

curl -F "DELSUB_2000154=3" \
 -F "api=" \
 -H "Authorization:Basic YOUR_API_KEY_GOES_HERE" \
 https://www.ragic.com/demo/sales/1/3

相应的 JSON 格式如下：

{
    "_DELSUB_2000154": [3]
}

使用 JSON 格式来删除子表格列让您以简单的方式指定多列：

{
    "_DELSUB_subtable key": [,..., ]
}