您在此处:
InsCensusServiceStd:findContacts
按名字、姓氏和电子邮件,或按搜索关键字和小组客户,搜索现有联系人。
类:InsCensusServiceStd
方法:findContacts
工作原理
-
如果服务请求负载包含具有名字、姓氏、电子邮件地址和小组客户的成员数组:
-
该服务查询联系人实体,并检索所有名字和/或姓氏和/或电子邮件地址和客户匹配的联系人。
-
所有匹配的联系人 ID、名字、姓氏和电子邮件都被添加到响应中的“联系人”节点列表中。
-
-
如果服务请求负载包含 searchKey 和小组客户:
-
如果给定的搜索关键字包含一个单词,服务会查询联系人实体,并检索部分/精确匹配姓名和客户的所有联系人。以给定搜索词开头的名称支持部分匹配。
-
如果给定的搜索关键字包含多个单词:
-
该服务仅考虑联系人搜索的前两个单词(用空格隔开),并忽略搜索关键字中的其余单词。
-
该服务查询联系人实体,并检索所有联系人(名字以搜索关键字的第一个单词开头,姓氏以搜索关键字的第二个单词开头)或客户(名字以搜索关键字的第二个单词开头,姓氏以搜索关键字的第一个单词开头)。
-
-
所有匹配的联系人 ID、名字、姓氏和电子邮件都被添加到响应中的“联系人”节点列表中。
-
输入
| 输入 | 描述 |
|---|---|
accountId
|
必填 GroupAccountId 联系人。 |
searchKey
|
如果使用成员,则需要此项。 用于搜索联系人姓名包含搜索关键字的一个或多个单词。 |
members
|
如果未使用 searchKey,则为必填项。 要在联系人中搜索的成员列表。 |
| 成员节点 | |
FirstName
|
名字 |
LastName
|
姓氏 |
Email
|
|
远程选项
| 选项 | 说明 |
|---|---|
accountId
|
必需。 GroupAccountId 联系人。 |
searchKey
|
如果使用成员,则需要此项。 用于搜索联系人姓名包含搜索关键字的一个或多个单词。 |
members
|
如果未使用 searchKey,则为必填项。 要在联系人中搜索的成员列表。 |
| 成员节点 | |
FirstName
|
名字 |
LastName
|
姓氏 |
Email
|
|
输入 JSON
以下是示例输入 JSON:
{
"contacts":[
{
"Id":"003B000000LEreFIAT",
"FirstName":"Christine",
"LastName":"Boon",
"Email":"cBoon@test.com"
},
{
"Id":"003B000000M07HDIAZ",
"FirstName":"David",
"LastName":"Boon",
"Email":"cBoon@test.com"
}
] }
输出 JSON
以下是示例输出 JSON:
{
"contacts":[
{
"FirstName":"Christine",
"LastName":"Boon",
"Email":"cBoon@test.com",
"Id":"003B000000LEreFIAT"
},
{
"FirstName":"Christine",
"LastName":"Boon",
"Email":"cBoon@test.com",
"Id":"003B000000M07HDIAZ"
},
...
] }