API 開發指南
遇到問題了嗎?不用擔心,答案都在這。
全站搜尋

修改資料

修改資料的端點與讀取現有資料的端點相同。請注意,當您建立資料時,端點指向一個 Ragic 表單,但當您編輯資料時,您的端點將需要額外的資料 ID 來指向確切的一筆資料

https://www.ragic.com////?api
您只需提供要修改的欄位 ID。如果欄位是日期欄位,則其值需要使用 yyyy/MM/ddyyyy/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": [,..., ]
}

回最上面 目錄

馬上註冊
免費試用 Ragic!

用 Google 帳號註冊

立即科技 Ragic, Inc.
02-7728-8692
info@ragic.com
台北市中正區南昌路二段81號9樓