【发布时间】：2020-05-21 15:59:37
【问题描述】：
在 RingCentral API 参考中有一个 Search/List Users function 需要过滤器表达式。这个过滤器表达式的语法是什么？过滤器参数的描述只是“暂时只支持'userName'或'email'过滤器表达式”。
【问题讨论】：
标签： api ringcentral scim scim2
【发布时间】：2020-05-21 15:59:37
【问题描述】：
Search/List Users API 是一个 SCIM 2.0 API，因此它遵循 IETF RFC-7644 定义的 SCIM 2.0 约定。
这是关于过滤的部分：
https://www.rfc-editor.org/rfc/rfc7644#section-3.4.2.2
3.4.2.2。过滤
过滤是 SCIM 服务提供商的可选参数。客户端可以通过查看
ServiceProviderConfig端点的filter属性来发现服务提供者过滤功能（参见第4 节）。客户端可以通过指定包含过滤器表达式的filter查询参数来请求资源子集。指定时，仅应返回与过滤器表达式匹配的那些资源。与 filter 参数一起使用的表达式语言支持对属性和文字的引用。过滤器中使用的属性名称和属性运算符不区分大小写。例如，以下两个表达式将计算出相同的逻辑值：
filter=userName Eq "john"
filter=Username eq "john"
对于 RingCentral，您可以使用以下示例：
https://platform.ringcentral.com/scim/v2/Users?filter=userName eq "john@example.com"
https://platform.ringcentral.com/scim/v2/Users?filter=email eq "john@example.com"
在 SCIM API 中，一个用户只能有一个用户名，但可以有多个电子邮件地址。对于 RingCentral，它们是相同的，因为 RingCentral 仅支持单个电子邮件地址。
【讨论】：