筛选条件

你的数据库中通常包含大量数据，因此在检索数据时建议套用筛选条件。Ragic API 筛选工具具有特殊格式。

你可以使用参数 "where" 来为搜索加入筛选条件，如下所示：

curl --get -d "where=2000123,eq,Alphabet Inc." \
-H "Authorization:Basic YOUR_API_KEY_GOES_HERE" \
-d api \
https://www.ragic.com/demo/sales/1

参数是逗号分隔格式，至少包含 3 个参数：

• 1. 你想要筛选的字段 ID。
• 2. 用于指定筛选操作的整数形式的运算符号。运算符号列表如下。
• 3. 你想要筛选字段的值。请记住，如果你的值可能包含逗号字符，请对其进行 URL 编码或使用 %2C 以避免冲突。

你可以用带有多个筛选条件的查询，如下所示：

curl --get -d "where=2000123,eq,Alphabet Inc." \
-d "where=2000127,eq,Jeff Kuo" \
-H "Authorization:Basic YOUR_API_KEY_GOES_HERE" \
-d api \
https://www.ragic.com/demo/sales/1

以下是支持的运算符号列表：

请注意：

1. 当你单击日期或日期时间筛选时，需要使用以下格式：yyyy/MM/dd 或 yyyy/MM/dd HH:mm:ss

2. 如果你想筛选空值，不需要填写第三个参数，例如，"where=2000127,eq,"。

3. 对同一字段，设置多个 eq、regex 或者 like，会以 OR 条件 进行筛选。例如，要检索字段 ID 1000001 为 Ratshotel 或 Claflin 的数据，可以使用 "where=1000001,eq,Ratshotel&where=1000001,eq,Claflin"。

4. 对同一字段，同时设置 gte/gt 和 lte/lt，则会以 AND 条件 进行筛选（适用于数值或日期字段，用来指定范围）。例如，要检索字段 ID 105 介于 2025/10/01 ~ 2025/10/31 的数据，可以使用 "where=105,gte,2025/10/01&where=105,lte,2025/10/31"。

有些系统字段具有特殊的字段 ID，你可以在查询中使用。常见的系统字段如下：

你还可以使用 全文检索 作为查询筛选条件。只需在参数 fts 中提供查询词，就会回传符合的结果。

curl --get -d "fts=Alphabet" \
-H "Authorization:Basic YOUR_API_KEY_GOES_HERE" \
-d api \
https://www.ragic.com/demo/sales/1

也可以套用共通筛选。只需设置如下 ID。

curl --get -d "filterId=YOUR_SHARED_VIEW_ID" \
-H "Authorization:Basic YOUR_API_KEY_GOES_HERE" \
-d api \
https://www.ragic.com/demo/sales/1

你可以透过点击共通筛选 URL 获取 ID。