1

在 RingCentral API 参考中有一个Search/List Users 函数需要一个过滤器表达式。这个过滤器表达式的语法是什么？过滤器参数的描述只是“暂时只支持'userName'或'email'过滤器表达式”。

4

1 回答 1

1

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 服务提供商的可选参数。客户端可以通过查看端点的filter属性来发现服务提供者过滤能力（见第 4 节）。ServiceProviderConfig客户端可以通过指定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 仅支持单个电子邮件地址。

于 2020-05-22T09:18:24.163 回答