大纲：
什么是 API，它是如何工作的
使用 Snov.io API 的好处
如何测试 Snov.io API
步骤 1. 使用 Postman 注册
步骤 2. 通用 API 调用设置
步骤 3. 获取 API 访问令牌
步骤 4. 进行测试 API 调用
在您的 Snov.io 工作流程中自动执行任务，将 Snov.io 直接集成到您的平台中，并从我们的数据库中检索邮箱地址。 Snov.io REST API 让这一切成为可能！
什么是 API，它是如何工作的
让我们快速了解基础知识并熟悉 API 是什么以及它是如何工作的。
API 代表应用程序编程接口，用于软件到软件的通信。 这是应用程序相互交谈和交互并根据请求提供数据或功能的一种方式。
您可以将其视为“聊天室”，其中一个应用程序或软件向另一个应用程序请求某些内容并获得实时响应。 在这个“聊天室”中进行通信的唯一方式是发送预定义的“问题”或“命令”（API 调用），同时服务器发回一个答案。
因此，API 调用是客户端（您）向服务器的 API (Snov.io) 发送请求并获得响应的过程。
四种最常见的 API 请求方法是：
- GET — 从指定 URL 的服务器检索数据
- POST — 将数据发送到服务器
- DELETE — 删除指定 URL 处的资源
- PUT — 发送数据以创建或更新资源
如果客户端（您）使用正确的参数提出正确的问题，服务器 (Snov.io) 将返回请求的数据或确认请求操作已完成的响应。
使用 Snov.io API 的好处
Snov.io API 为您提供了扩展应用程序/网站功能的绝佳机会。
使用 Snov.io API，您可以：
- 在 Snov.io 和您的应用程序/自定义构建的 CRM 之间创建自定义集成
- 请求 Snov.io 共享数据并丰富您自己的服务
- 触发与潜在客户管理相关的操作（例如，创建新的潜在客户列表、将潜在客户添加到列表等）
- 使用邮箱地址查找工具和邮箱验证功能
- 检索有关您的自动化邮件营销的统计信息
- Snov.io 提供 REST 类型的 API，让您更容易使用。 在 REST API 中，数据和功能作为资源作为唯一 URL 提供。 要让 Snov.io 通过 API 共享数据，您只需输入 URL、设置查询参数并验证您的请求。
如何测试 Snov.io API
了解 Snov.io API 工作原理的最简单方法是使用 API 测试工具。 我们将使用 Postman，因为它众所周知，相对容易使用，并且有免费版本。
让我们从 Postman 对 Snov.io 进行第一次 API 调用！
步骤 1. 使用 Postman 注册
在官方网站上使用 Postman 应用程序注册并创建您的帐户。
在 Home (1) 选项卡中，单击 Send a request (2) 按钮以进入 API 测试环境。
步骤 2. 通用 API 调用设置
对 Snov.io API 的每个请求都包括：
- 请求方法 – POST 或 GET (1)
- URL – 请求的 HTTPS 地址 (2)
- 输入参数——键及其值 (3)
- 输出/响应——请求的数据或请求完成响应 (4)
下面是在 Postman 测试环境中输入 API 调用设置的地方：
提示：对于 GET 请求，在 Params 选项卡中输入输入参数。 对于 POST 请求，在 Body 选项卡→ form-data 选项卡中输入输入参数。
步骤 3. 获取 API 访问令牌
在发出请求之前，您需要生成访问令牌以验证您未来对 Snov.io 的 API 调用，并在 Snov.io API“聊天室”中将自己标识为 Snov.io 客户端。
访问令牌是您每次对 Snov.io 进行 API 调用时都需要出示的个人“通行证”。
在对 Snov.io API 的每个请求中，都需要在 Authorization 字段中指定此访问令牌（稍后我们将解释如何在 Postman 中执行此操作）。
(1) 类型：POST
(2) 请求网址：https://api.snov.io/v1/oauth/access_token
- 输入参数：
| Key | Value |
| grant_type (1) | client_credentials |
| client_id (2) | 在 账户设置里获得User ID |
| client_secret (3) | 在 账户设置里获得API Secret |
输入所有参数后，单击发送 (1) 按钮并在输出/响应部分获取您的访问令牌 (2)。 保存或复制它以在将来的 API 调用中使用。
注意 #1：出于安全目的，访问令牌的生命周期等于 3600 秒（1 小时）。 您需要每 1 小时生成一个新的访问令牌。
注意#2：令牌类型是 Bearer。 您需要在授权下一个请求时指定令牌类型。
现在让我们了解一些您可以定向到 Snov.io API 的 API 调用。
步骤 4. 进行测试 API 调用
域名搜索 V.2
您可以要求 Snov.io API 每次调用最多共享 100个域名。 作为回复，每 10 个邮箱地址/潜在客户需要 1 个点数。
要在 Postman 中验证您的 API 调用：
转到 Postman 中的授权选项卡 (1)，选择承载令牌 (2) 类型，然后粘贴您的访问令牌 (3)。
返回到 Params 选项卡以输入域名搜索 API 调用设置：
(1) 类型：GET
(2) 请求网址：https://api.snov.io/v2/domain-emails-with-info
(3) 输入参数：
| Key | Value |
| domain | 你想要搜索邮箱的关联域名 |
| type | 所有邮箱，个人邮箱，通用邮箱 |
| limit | 你想要从一个域名下获得邮箱的数量(最多100个) |
| lastId | 默认值为 0. 如果要从一个域名内获得多于100个邮箱, 在您的下一次请求中, 指定上一个请求中的 last_id 返还值 |
| position or positions | 输入一个特定的职位，以过滤从一个域名中获得的潜在客户信息 |
注意 #1：如果您要求提供通用邮箱地址，您将获得基于角色的电子邮件地址，例如 contact@snov.io。 个人邮箱邮件地址是在公司工作的实际人员的邮箱地址。 如果您将 all 指定为一种类型，您将同时收到个人邮箱和通用邮箱地址。
注意 #2：要从域名中获取超过 100 个邮箱地址，请在您的下一个请求中，指明上一个请求的 last_id 响应值。
输入所有设置后，单击发送按钮以查看 Snov.io 必须共享的邮箱地址。
- 邮箱验证工具
使用 Snov.io API，您可以检查提供的电子邮件地址是否有效。 此 API 调用是免费的。
首先，确保使用授权选项卡中的访问令牌对您的 API 调用进行身份验证。
接下来，在 Postman 中打开 Body 选项卡→表单数据选项卡，然后进入 Email Verifier API 调用设置：
(1) 类型：POST
(2) 请求网址：https://api.snov.io/v1/get-emails-verification-status
(3) 输入参数：
Key：邮箱地址[]； 值 – 您要检查的邮箱地址地址数组（列表）。
输入所有参数后，单击发送按钮以在输出/响应部分查看邮箱地址状态：“有效”、“not_valid”、“灰名单”或“未知”。
如果您在“输出/响应”字段中收到“not_verified”标识符，则表示我们之前未验证此电子邮件地址。 您应该使用添加邮箱地址进行验证 API 调用来验证此邮箱地址（每个邮箱地址 1 点数），然后重复邮箱验证工具 API 调用（免费）以查看验证结果。
Snov.io API 调用
所有 Snov.io API 调用都以类似的方式工作 – 您输入 URL、输入参数和访问令牌以获取响应：
- 域名搜索 V.2
- 邮箱地址计数
- 邮箱地址查找
- 添加名称以查找邮箱地址
- 添加 URL 以搜索潜在客户信息
- 获取包含URL的潜在客户信息
- 获取包含邮箱地址的个人资料
或触发某个动作，例如以下之一：
- 将潜在客户添加到列表
- 按 ID 查找潜在客户
- 通过邮箱地址查找潜在客户
- 查找潜在客户的自定义字段
- 查看用户列表
- 在列表中查看潜在客户
- 创建新的潜在客户列表
Snov.io API 限制
Snov.io API 对每小时和每分钟可以调用的 API 数量有一定的限制。
每分钟限制为 60 个 API 调用。
每小时限制取决于您的套餐：
邮箱地址查找工具 API 调用限制：
- S — 200 个请求/小时
- M — 400 个请求/小时
- L — 600 个请求/小时
- XL — 800 个请求/小时
- XXL — 1000 个请求/小时
邮箱地址验证工具 API 调用限制：
- S — 500 个请求/小时
- M — 1000 个请求/小时
- L — 1400 个请求/小时
- XL — 2000 个请求/小时
- XXL — 4000 个请求/小时
您可以在我们的 API 文档中查看可用 API 调用、其参数、信用成本和限制的完整列表。
没有您自己的应用程序来连接 Snov.io API，但想集成您喜欢的应用程序？ 了解如何使用 Zapier 集成。
需要访问 Snov.io API？ 请随时与我们的代表联系以安排测试会议。
非常抱歉 😢
我们可以如何改善？