搜索/列出用户 在 RingCentral SCIM 2.0 API 中筛选表达式语法



在RingCentral API参考中,有一个需要过滤器表达式的搜索/列表用户函数。此筛选器表达式的语法是什么?过滤器参数的描述只是"目前仅支持'用户名'或'电子邮件'过滤器表达式"。

搜索/列出用户 API 是一个 SCIM 2.0API,因此它遵循 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"

对于环中环,您可以使用以下示例:

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仅支持一个电子邮件地址。

最新更新