我是一个毫不掩饰的沙发土豆。我订购杂货、送餐、计算前往巴诺书店的车程、查看天气以确认呆在室内是 最好的行动方案——所有这一切都在我舒适的沙发角落进行。您可能会认为这很可悲，但我认为这只是方便- 而且我将这些便利归功于 API 的强大功能。 通过自动化简化跨部门工作 学习如何 API（即应用程序编程接口）使我们日常生活的便利成为可能。它们连接不同的应用程序，使它们能够轻松地通信和共享信息。API 还执行许多新应用程序编程的繁重工作。 我与 API 专家合作，整理了这份初学者指南和有关如何使用它们的教程。 目录： 什么是 API？ 为什么使用 API？ API 入门 如何使用 API 如何将应用程序连接到 API就像一个数字中介，使不同的软件应用程序能够相互通信并交换信息。它定义了可用于访问某些功能或从应用程序或服务检索数据的方法、参数和数据格式。 该图显示了 API 是什么以及它的工作过程。 想想你最喜欢的天气应用程序。它依靠 API 从气象服务获取实时天气数据并将其传送到您的设备。或者，当您使用社交媒体平台登录另一个应用程序时（登录 Facebook 玩 Candy Crush 会敲响警钟吗？），后台有一些 API 可以安全地验证您的身份。 为什么使用 API？ 如果没有 API，我们实际上必须使用纸质地图才能在任何地方找到路（而且我 100% 的时间都会迷路）。API 可让您从现有来源访问数据，而无需重新发明轮子。因此，当您使用您最喜欢的导航应用程序时，您实际上是在向手机信号塔和全球定位系统 (GPS) 发送请求以访问位置数据。 在软件开发方面，API 提供了一条捷径，允许开发人员利用预构建的功能，以便他们可以集中精力构建新功能。例如，Planefinder可以实时跟踪飞机。他们没有花时间制作自己的世界地图，而是使用 Google 地图 API，这样他们就可以将时间花在其他功能上。 API 还促进不同系统之间的集成，从而实现跨应用程序的无缝数据交换。当企业需要跨应用程序共享信息（例如将CRM与电子邮件连接）时，这会派上用场。Zapier使用应用程序的 API 提供数千个无代码集成，因此技术堆栈中的所有应用程序都可以相互通信（希望无需离开家）。 Zapier 是一款无代码自动化工具，可让您将应用程序连接到自动化工作流程中，以便每个人和每个企业都能以增长速度向前发展。详细了解其工作原理。
API 入门 我将向您抛出大量术语，因此在开始之前，您应该了解以下一些 API 术语。 学期 定义 API密钥 由字母和数字组成的唯一密码，用于授予 API 访问权限 端点 API 接收有关其资源的请求的数字位置 请求方式 使用 HTTP 方法（GET、POST、PUT、DELETE）告诉 API 您希望它做什么 API调用 客户端（您的计算机）向服务器发出 API 请求的过程 状态码 API 响应正文中显示的数字代码，用于告诉您请求是否成功 API 密钥 与密码一样，API 密钥是一串字母和数字，用作唯一的访问代码或身份验证令牌。您需要一个来访问大多数 API。这是一种帮助跟踪和控制 API 使用情况的安全措施，因此只有授权用户或应用程序才能访问数据。与您需要密码来 秘鲁手机号码列表 访问应用程序类似，您需要 API 密钥来访问 API。 稍后我们将介绍如何查找和使用这些密钥。 端点 端点是 API 与另一个应用程序连接的地方，通常采用特定 URL 或 Web 地址的形式。端点充当接收请求和发送对这些请求的响应的位置。它们是用户使用 API 的清晰且标准化的方式。 想象一下自动售货机。你可以看到里面有所有不同的零食，你必须按下一个特定的按钮才能收到你想要的零食。API 端点就像自动售货机上的按钮，代表您想要从 API 获得的特定信息或操作。当您通过向 API 端点发出请求来“按下”该按钮时，API 知道您想要什么信息或操作，并为您提供所需的士力架（呃，响应）。 请求方式 要通过 API 端点传达您想要完成的任务，您需要发出请求。您可以使用四种特定的 HTTP 方法： GET：用于从 API 检索特定数据。 POST：这告诉 API 您想要向服务器添加或发布新数据。 PUT：这用于更新 API 上的现有资源。 删除：您猜对了，这用于从服务器删除现有数据。 您还可能会看到这些请求被称为 CRUD 或创建、读取、更新和删除。大多数公共 API 只允许您执行 GET（读取）请求，以防止人们弄乱他们的数据。毕竟，您不希望任何人都 可以使用气象 API 并更改天气数据。 API调用 API 调用是发出请求、API 检索您请求的数据，然后从 API 获取响应的过程。您唯一需要做的就是使用上述 HTTP 方法之一发出请求。 想象一下当您在咖啡店点一杯饮料时。你告诉咖啡师你想要什么，他们把你的订单输入系统，然后咖啡师把饮料递给你。API 调用的工作方式相同，但结果含咖啡因较少。
描述 API 调用如何工作的图形。 状态代码 对于您提出的每个请求，您都会收到一个状态代码。这个三位数告诉您请求是否成功。代码中的第一个数字代表状态的类别。如果代码以 2 开头，则您的请求已成功处理。如果代码以 4 开头，则表示出现问题。状态代码可让您了解请求的结果，并根据响应确定下一步行动。 如何使用 API 我将使用 Python (3) 向您展示使用 API 的示例。您可以使用其他编码语言，甚至还有适合初学者的 API 平台，例如 Postman 或 RapidAPI（适用于 Mac），为 API 提供用户友好的界面。但 Python 是一种非常容易使用 API 的方式，即使您并不完全精通该语言。 1. 选择一个 API 有数千个公共 API 可供使用。您可以搜索r 等目录来查找您感兴趣的目录。如果您正在寻找特定的 API，大多数网站都会在“高级设置”或“开发人员”部分（通常位于网站底部）下列出它们。 显示 Spotify 网站上的开发者链接的屏幕截图。 在本教程中我将使用 Google 的Gmail API。 显示在 G上查找 Gmail API 的位置的屏幕截图。 2.查阅API文档 每个 API 都应该为您提供某种类型的文档来启动。通常，会有一个参考部分提供您可以访问的各种对象、参数和端点。通常还会有一个示例，或者对于 Gmail API，还有一个“快速入门”，以几种不同的流行语言表示。这份文件告诉你： 您可以使用 API 做什么 使用 API 的依赖性和要求 如何使用API 您还可以在本文档中找到 API 密钥（如果有）。 显示 Gmail API 文档的屏幕截图。 要学习本教程，您需要： 安装（或更高版本）。 安装pip包管理器。 创建一个Google Cloud 项目。 创建一个 Gmail 帐户（如果您还没有）。 3. 写请求 现在是时候编写请求，或者告诉 API 您希望它做什么。这就是发挥作用的地方。 以下是如何使用 Google 提供的样板代码从 Gmail 的 API 执行 GET 请求。这将检索您在 Gmail 中保存的标签并将其记录到您的控制台。 复制示例快速入门代码。 显示在 Gmail 的 API 文档中复制示例代码的屏幕截图。 打开文本编辑器，例如适用于 Mac 的TextEdit或适用于 Windows 的记事本。将代码粘贴到文本编辑器中。 在您将保存该项目的所有文件的文件夹中另存为sample.py 。这称为您的工作目录。
发表于 2023-11-8 13:22:21
