Skip to main content
POST
通过联系标识查找人员

授权

pubrio-api-key
string
header
必填

一个唯一的 API 令牌,用于标识您通过 API 执行的操作以及相应的权限和操作。您可以在 设置 部分创建该令牌。

请求体

application/json
email
string<email>
必填

要查找的工作或个人电子邮箱地址。系统会在匹配前规范化大小写和空白字符。

phone
string

要查找的电话号码。建议使用国际格式(E.164)。

示例:

"+15551234567"

first_name
string

名字。当 is_enable_similarity_searchtrue 时,与 last_name 以及 domaincompany 配合使用。

示例:

"King"

last_name
string

姓氏。当 is_enable_similarity_searchtrue 时,与 first_name 以及 domaincompany 配合使用。

示例:

"Lai"

domain
string

公司域名。当 is_enable_similarity_searchtrue 时,与 first_name + last_name 一起作为相似度搜索的锚点。

示例:

"pubrio.com"

company
string

公司名称。当 is_enable_similarity_searchtrue 且未提供 domain 时,与 first_name + last_name 一起作为相似度搜索的锚点。

示例:

"Pubrio"

设为 true 时,若未找到精确匹配的邮箱/电话,将回退到基于姓名的相似度匹配。需要提供 first_namelast_name 以及 domaincompany

示例:

true

profile_id
integer

可选。发起请求的团队标识符。由于 API 密钥已包含您的工作区信息,此参数不再是必填项。如果提供,该 ID 有助于将查找与特定团队(工作区)关联,实现数据检索和额度追踪。

更多信息请参见团队标签下的 user details 端点。

响应

成功响应,包含匹配到的人员及匹配元数据。

data
object | null

响应信息取决于具体接口。