修改数据的端点与读现有数据的端点相同。请注意,当您创建数据时,端点指向一个 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": [
,..., ] }