新手产品经理的API入门指南

幂简集成

已于 2023-12-01 15:15:39 修改

阅读量223

点赞数 6

分类专栏： API基础知识文章标签： java servlet 开发语言产品经理

于 2023-12-01 15:15:05 首次发布

本文链接：https://blog.csdn.net/Explinks/article/details/134733426

版权

API基础知识专栏收录该内容

6 篇文章 0 订阅

订阅专栏

在当前迅速发展的技术环境下，API已经成为软件开发不可或缺的核心组成部分。对于新人产品经理而言，熟悉和理解如何调用、管理和解读API是至关重要的技能。本文将以产品经理的视角为出发点，深入探讨API的本质，并对比API与SDK的区别，旨在帮助产品经理更好地运用API，并促进其与开发团队更有效的沟通和协作。

什么是API？

API，即应用程序编程接口（Application Programming Interface），根据最基础的定义去阐释，就是一些预先定义的函数，目的是提供应用程序与开发人员基于某软件或硬件得以访问一组例程的能力，而又无需访问源码，或理解内部工作机制的细节。

用更通俗的话说，API就像是一条街道，把各种不同的房子连接起来。这些房子其实就是各种不同的功能。API本身并没有实际功能，但它负责连接这些功能，让它们可以相互交流和互动。

我们每天使用的大多数Web应用程序都有API在背后支持，比如在一个程序注册新账号需要身份认证，开发者无需重新造轮子，直接调用例如身份证二要素的API，快速验证当前用户信息是否真实有效。

对于产品经理来说，明晰以下这五点是很重要的：

接口地址：接口地址分为正式URL和测试URL，通过向此地址发送请求来对接口进行交互。
请求方式：一般有POST、GET、PUT和DELETE等。
请求参数（入参）：向接口请求时，所携带参数的字段名称和规则。
返回结果（出参）：返回内容一般以JSON和XML的形式返回。
错误码：请求有误返回的提示，包含请求的返回状态、错误原因及解决措施。

API结构

我们现在已经知道了什么是API，那么接下来就是了解如何使用。在展示调用API之前，需要注意一点，API提供者会根据服务等级协议（SLA）设定限制，包括每秒/每分钟/每小时的最大调用次数或速率限制，以确保资源的合理分配和服务稳定性，避免过度使用或滥用API服务。超出限制的调用可能会导致请求被拒绝或延迟处理。

此外，除了调用次数，还要关注API的版本问题，当API提供者进行更新、改进功能或修复bug时，会发布新的API版本。版本通常以数字、日期或标签形式标识，如v1、v2、2022-01-01等。新版本可能包含新增功能、改进性能或修复现有问题，而旧版本可能会逐渐被淘汰或不再支持。因此为了避免出现项目故障等问题，应对API的版本定期进行更新。

API调用流程

为了更好的展示，我们将通过API工具和代码两种方式来展示API调用流程。

使用API工具调用身份认证服务的步骤：

步骤一：准备工作

已经获得了测试账号和身份验证的API文档。在API工具中新建请求

步骤二：设置请求方式和URL

选择合适的HTTP请求方法（通常是POST请求）。

将身份认证服务的URL粘贴到请求栏中。例如：`https://your-company.com/api/authentication`

步骤三：设置请求头

在Headers部分添加所需的头部信息。通常，这会包括内容类型和授权信息。可以根据具体场景查看API文档中有关请求头部的说明。

步骤四：添加请求参数

如果有请求参数，将其添加到Body或Params中，具体取决于API的要求。身份认证可能需要用户名、密码、或者令牌等信息。

步骤五：发送请求

单击“发送”按钮，向API服务发送身份认证的请求。

步骤六：查看响应

如果身份验证成功，通常会收到令牌或认证成功的消息。

步骤七：验证结果

验证响应消息，检查是否成功获取了认证令牌或返回了正确的响应。如果有错误或失败，查看响应状态码和文档以获取更多信息。

接下来，再看通过代码调用API的具体流程：

步骤 1：设置API的基本信息

需要指定API的主机地址（host）、路径（path），以及请求方法（method）。这相当于告诉计算机在哪里查找API，要请求哪个路径，以及使用什么方法来获取数据。

String host = "https://open.expauth.com";

String path = "/v1/tools/person/idcard";

String method = "POST";

步骤 2：设置请求头部信息

头部信息包括应用程序代码（AppCode），请求的签名信息，以及请求的内容类型。这就相当于在请求中提供了你的身份信息和请求的格式。

String appcode = "{{AppCode}}";

Map headers = new HashMap<>();

headers.put("X-Mce-Signature", "AppCode/" + appcode);

headers.put("Content-Type", "application/x-www-form-urlencoded; charset=UTF-8");

步骤 3：设置查询参数和请求体数据

这一步涉及设置查询参数和请求体数据。在这个示例中，我们将姓名和身份证号添加到请求体数据中。这就相当于在请求中提供了需要的数据。

Map querys = new HashMap<>();

Map bodys = new HashMap<>();

bodys.put("name", "name");

bodys.put("idCardNo", "idCardNo");

步骤 4：发送HTTP请求

在这一步中，我们使用以上设置发送了HTTP POST请求到API服务器。这相当于向API服务器发送请求，就像使用乐高积木的两个部件来连接它们一样。

HttpResponse response = HttpUtils.doPost(host, path, method, headers, querys, bodys);

步骤 5：处理响应

最后，我们接收API服务器的响应。响应包括一个状态码（statusCode）和响应内容（resStr）。这就相当于查看API服务器的回应，确认请求是否成功以及获取响应的内容。

String resStr = EntityUtils.toString(response.getEntity());

int statusCode = response.getStatusLine().getStatusCode();

当然，实际的开发过程可能会因API提供商的要求、API的具体性质和开发者的需求而有所不同。例如，一些API可能需要更复杂的身份验证方式，如OAuth，而不仅仅是简单的API密钥。此外，API的文档和要求也可能因提供商而异。

因此，在实际开发中，开发者通常需要仔细阅读API提供商的文档，以了解如何正确地调用API，包括身份认证和其他请求参数的设置。每个API都可能有自己的特定要求，因此了解提供商提供的具体信息是非常重要的。

API和SDK的区别

当涉及到理解API和SDK之间的区别时，一个直观的对比图表可以帮助阐明它们的关系。API（应用程序编程接口）是一组定义软件和不同组件之间交互的规范，允许不同的应用程序相互通信和交换数据。相比之下，SDK（软件开发工具包）是一组用于创建应用程序的工具、库和实用程序的集合。

特征	API（应用程序编程接口）	SDK（软件开发工具包）
定义	一组用于建立软件应用程序的协议、工具和定义。	一套工具、指南和程序，用于帮助开发者创建特定平台的软件应用。
组成	通常只包含与特定功能或服务相关的接口。	包含一组API、编程工具、文档和其他用于开发软件的元素。
用途	使不同软件应用程序之间能够交互和通信。	提供一整套开发工具，用于构建特定平台或技术上的应用程序。
范围	通常专注于单一功能或一小组相关功能。	提供更广泛的功能和资源，覆盖特定平台或技术的多个方面。
集成方式	直接嵌入到应用程序中，以实现特定功能。	通常作为完整的软件包提供，包括用于开发和测试的多种工具。
例子	网络服务API、数据库接口、远程过程调用等。	Android SDK、iOS SDK、Microsoft .NET Framework SDK等。

API vs SDK

使用场景可以更清晰地说明它们的区别。比如，API是连接两个不同系统的桥梁，就像一台翻译机，允许它们之间进行交流。而SDK更像是一个工具包，提供了一系列工具和资源，帮助开发者更轻松地构建特定平台或语言的应用程序。比如，想象你在建一座房子，API就像是连接房子和水电气的管道，而SDK就像是装修工具包，提供了建房所需的各种工具。