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

筛选条件

你的数据库中通常包含大量数据,因此在检索数据时建议套用筛选条件。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

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

运算符号名称 运算值
等于 eq
正规表示法 regex
大于等于 gte
小于等于 lte
大于 gt
小于 lt
包含 like
等于 node id eqeq

请注意:

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

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

3. 对于同一字段的 OR 筛选,可以透过加入多个 where 查询来实现。例如,要检索字段 ID 1000001 为 Ratshotel Claflin 的数据,可以使用 "where=1000001,eq,Ratshotel&where=1000001,eq,Claflin"

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

系统字段名称 字段 ID
创建日期 105
数据管理员 106
创建用户 108
最后更新日期 109
通知用户 110
是否上锁 111
是否打星号 112

你还可以使用 全文检索 作为查询筛选条件。只需在参数 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。

回最上面 目录

马上登记
免费试用 Ragic!

用 Google 帐号登记

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