获取人员详情

如果消费者对我们公司提供的服务感兴趣，我们可能会迎来新的注册用户。然而，只有经过身份验证的用户注册才有价值，虚假注册则无意义。我们如何判断这一点？一种方法是花费大量时间调查用户，另一种更高效的方法是使用 Clearbit 的增强 API。该 API 提供三个接口：

1. 人员接口（Person API）
2. 公司接口（Company API）
3. 综合接口（Combined API）

---

接口说明

人员接口（Person API）

请求地址：

1https://person.clearbit.com/v2/people/find?email={email_of_person}

---

示例邮箱地址

• andrew@airbnb.com
• sundar@google.com
• marc@salesforce.com
• fahim@educative.io

---

JavaScript 代码示例

1import fetch from 'node-fetch';
2
3const API_KEY = 'Bearer {{API_KEY}}';
4
5const endpointUrl = new URL('https://person.clearbit.com/v2/people/find');
6
7const headerParameters = {
8  authorization: API_KEY,
9  contentType: 'application/json',
10};
11
12const queryParameters = new URLSearchParams({
13  email: '{{EMAIL}}'
14});
15
16const options = {
17  method: 'GET',
18  headers: headerParameters,
19};
20
21async function fetchData() {
22  try {
23    endpointUrl.search = queryParameters;
24    const response = await fetch(endpointUrl, options);
25
26    // 自定义函数：打印 API 响应
27    printResponse(response);
28  } catch (error) {
29    // 自定义函数：打印错误信息
30    printError(error);
31  }
32}
33
34// 调用函数发起 API 请求
35fetchData();

---

返回字段说明

---

修正不准确信息

Clearbit 的人员查询采用模糊匹配，因此可能存在不准确的结果。为了帮助 Clearbit 改进数据质量，你可以使用其 标记人员 接口，将错误信息标记为不正确，并提交正确的属性值，以便他们进行修正。该操作通过 POST 方法完成。

标记人员接口地址：

1https://person.clearbit.com/v1/people/{id_of_person}/flag

---

标记人员代码示例

1import fetch from 'node-fetch';
2
3const API_KEY = 'Bearer {{API_KEY}}';
4
5const endpointUrl = new URL('https://person.clearbit.com/v1/people/{{ID}}/flag');
6
7const headerParameters = {
8  authorization: API_KEY,
9  contentType: 'application/json',
10};
11
12const options = {
13  method: 'POST',
14  headers: headerParameters,
15};
16
17async function fetchData() {
18  try {
19    const response = await fetch(endpointUrl, options);
20
21    // 自定义函数：打印 API 响应
22    printResponse(response);
23  } catch (error) {
24    // 自定义函数：打印错误信息
25    printError(error);
26  }
27}
28
29// 调用函数发起 API 请求
30fetchData();