修改資料

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": [,..., ]
}