了解 API:应用程序如何通信:
api(应用程序编程接口)是一组规则和定义,允许一个软件应用程序与另一个软件应用程序进行通信。它充当中介,通过定义不同的软件系统可以发出的请求类型、如何发出这些请求、数据格式以及系统应如何响应,使不同的软件系统能够相互交互。
api 中的关键概念
-
端点:
- 这些是 api 公开的特定 url,以允许外部应用程序与其交互。例如,如果您想从天气 api 获取数据,您可以向特定端点发送请求,例如 https://api.weather.com/v1/forecast。
-
请求和响应:
-
请求:应用程序向api端点发送请求,指定它想要什么数据或操作。
-
响应:api 发回响应,其中可以包含数据(通常采用 json 或 xml 格式)、状态代码和消息。
- 状态代码示例:
-
200 ok:请求成功。
-
404 not found:端点不存在。
-
500 内部服务器错误:服务器端出现问题。
-
http 方法:
api 通常使用特定的 http 方法进行请求,例如:
-
get:检索数据。
-
post:提交数据以创建或更新资源。
-
put:更新或替换资源。
-
删除:删除资源。
-
api 密钥和身份验证:
某些 api 要求用户在发出请求之前验证自己的身份。这是通过以下方式完成的:
-
api 密钥:用于验证用户或应用程序的唯一标识符。
-
oauth:一种更高级的协议,允许用户通过第三方服务进行身份验证,而无需共享其凭据。
速率限制:
许多 api 限制应用程序在特定时间范围内可以发出的请求数量。这是为了确保服务器不会因单一来源的过多请求而不堪重负。
-
restful api:
具象状态传输 (rest) 是一种用于构建 api 的流行架构。 restful api 是无状态的,并使用标准 http 方法。 rest 的关键原则包括:
-
无状态:从客户端到服务器的每个请求都必须包含理解和处理该请求所需的所有信息。
-
统一接口:资源应该通过统一的url结构来访问。
-
资源表示:资源通常使用 json 或 xml 等格式表示。
soap api:
soap(简单对象访问协议)是另一种用于构建 api 的协议,它更加结构化并包含标准化的消息传递系统。它更安全,非常适合安全性优先的应用程序(例如银行业务)。
api交互示例
假设您有一个天气应用程序,并且您想获取纽约市的当前天气。 api 交互如下所示:
- 您的应用程序向 api 端点发送 get 请求:
https://api.weather.com/v1/city/newyork
- 服务器处理请求并以 json 格式发回 响应:
{
"city": "New York",
"temperature": "15°C",
"description": "Clear sky"
}
您的应用现在可以向用户显示此信息。
api 类型
-
web api:这些是最常见的,用于通过网络与远程服务器交互,例如 rest 或 soap api。
-
操作系统 api:允许软件与操作系统交互的 api。
-
数据库 api:它们支持与数据库交互,允许应用程序读取或修改数据库中存储的数据。
-
库或框架api:这些是库或框架提供的api,允许开发人员重用代码,而无需重新发明轮子。
api 在现代软件开发中至关重要,它允许不同的服务和应用程序无缝协作。它们用于 web 开发、移动应用程序、物联网设备等等。