使用 Office 365 Rest 按姓名查询联系人 API

Question

是否可以使用 OData 过滤器按姓名（GiveName、DisplayName、LastName 或 Surname）搜索联系人？

我在文档中看到他们说某些属性无法过滤，但没有给出完整列表（列出了复杂类型，但不包括联系人姓名）。

我的猜测是不，因为当我尝试时：

/contacts?$filter=DateTimeCreated+ge+2014-09-01T00:00:00Z

我收到一个包含正确数据的 200 响应，但是当我尝试使用任何名称属性时：

/contacts?$filter=DisplayName+eq+Jordan+Example
/contacts?$filter=LastName+eq+Example
/contacts?$filter=Surname+eq+Example

我收到 400 错误响应，响应正文中没有详细信息，但我知道（并仔细检查）联系人存在。

也喜欢使用通配符进行搜索，但尽量不要太贪心。

Answer 1

它应该可以工作，但您需要将您的值用单引号 (') 括起来。尝试：

/contacts?$filter=DisplayName eq 'Jordan Example'
/contacts?$filter=LastName eq 'Example'
/contacts?$filter=Surname eq 'Example'

Query contacts by name using Office 365 Rest API