API 开发指南
遇到问题了吗?不用担心,答案都在这。
全站搜索

创建新纪录

如果您不是只用 HTML 表单来在 Ragic 创建数据,则需要通过 API 请求来创建。写入表单的端点与读表单的端点相同,但您需要发送 POST 请求而不是 GET 请求。

API 支持 JSON 格式,并且推入荐使用此方式运行 HTTP 请求。

要发送 JSON 数据,您需要将 Body 设置更改为源 JSON,如下图所示。

要做的是使用字段的 ID 作为名称,并将要插入的值作为参数值。

请注意,您的用户需要对该表单具有编辑权限才能使用此功能。


curl -F "2000123=Dunder Mifflin" \
 -F "2000125=1-267-922-5599" \
 -F "2000127=Jeff Kuo" \
-F "api=" \
 -H "Authorization:Basic YOUR_API_KEY_GOES_HERE" \
 https://www.ragic.com/demo/sales/1

JSON 格式如下所示:


{
    "2000123": "Dunder Mifflin",
    "2000125": "1-267-922-5599",
    "2000127": "Jeff Kuo",
}

如果字段是可以包含多个值的多选字段,您可以使用多个具有相同字段 ID 的参数名。如果字段是日期字段,则其值需要使用以下格式:yyyy/MM/dd 或者带有时间部分 yyyy/MM/dd HH:mm。因此,一个请求的格式会像这样:


curl -F "2000123=Dunder Mifflin" \
 -F "2000125=1-267-922-5599" \
 -F "2000127=Jeff Kuo" \
 -F "1000001=Customer" \
 -F "1000001=Reseller" \
 -F "2000133=2018/12/25 23:30:00" \
 -F "api=" \
 -H "Authorization:Basic YOUR_API_KEY_GOES_HERE" \
 https://www.ragic.com/demo/sales/1

相应的 JSON 格式如下,方括号内的 1000143 字段 ID 许可在一个语句中包含多个值。

{
    "2000123": "Dunder Mifflin", 
    "2000125": "1-267-922-5599", 
    "2000127": "Jim Halpert",
    "1000001": ["Customer", "Reseller"],
    "2000133": "2018/12/25 23:30:00" 
}

如果您想要同时插入数据到子表格中,您需要对子表格中的字段使用略有不同的格式,因为 Ragic 需要一种方法来确定字段值是否属于子表格中的同一笔数据。

如果字段值在同一子表格列中,请将它们与每个其他字段分配相同的负行 ID。这可以是任何负整数。这只是一种确定它们属于同一列的方法。

2000147_-1=Bill
2000148_-1=Manager
2000149_-1=billg@microsoft.com

2000147_-2=Satya
2000148_-2=VP
2000149_-2=satyan@microsoft.com

The whole request would look like this:


curl -F "2000123=Dunder Mifflin" \
 -F "2000125=1-267-922-5599" \
 -F "2000127=Jeff Kuo" \
 -F "1000001=Customer" \
 -F "1000001=Reseller" \
 -F "2000133=2018/12/25 23:30:00" \
 -F "2000147_-1=Bill" \
 -F "2000148_-1=Manager" \
 -F "2000149_-1=billg@microsoft.com" \
 -F "2000147_-2=Satya" \
 -F "2000148_-2=VP" \
 -F "2000149_-2=satyan@microsoft.com" \
-F 'api=' \
 -H "Authorization:Basic YOUR_API_KEY_GOES_HERE" \
 https://www.ragic.com/demo/sales/1

相应的 JSON 格式如下:

{

    "2000123": "Dunder Mifflin", 
    "2000125": "1-267-922-5599", 
    "2000127": "Jim Halpert",
    "1000001": ["Customer", "Reseller"],
    "2000133": "2018/12/25 23:30:00" 
    "_subtable_2000154": {
        "-1": {
            "2000147": "Bill",
            "2000148": "Manager",
            "2000149": "billg@microsoft.com"
        },
       "-2": {
            "2000147": "Satya",
            "2000148": "VP",
            "2000149": "satyan@microsoft.com"
        }
    }
}

如果您想填入文件上载字段,请确保请求的编码类型是multipart/form-data。在 HTML 中的等效操作是设置 enctype='multipart/form-data'。

使用多部分请求,您可以将文件放入请求中,并将文件名作为字段值。


1000088=test.jpg

回最上面 目录

马上登记
免费试用 Ragic!

用 Google 帐号登记

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