编程基础之什么是API二

76 阅读2分钟

开启掘金成长之旅!这是我参与「掘金日新计划 · 12 月更文挑战」的第28天,点击查看活动详情

书接上文,我们继续来说一下编程的技术概念,举一个非常常见的例子:

API 的组件

API 具有 3 个元素 - Request、Response 和 Resource

  • 请求 - 你要求翻译小哥对德国人翻译一句 早上好 就是请求
  • Response——德国人说回来的就是回应
  • 资源 - 响应中的数据'Guten Tag'(德语你好的意思)是资源

在我们上面的程序中,让我们看看 API 需要做什么:

我们的程序请求获得 currency_a -> currency_b 的汇率 响应 -- API 端点读取我们的请求,获取该信息,并作出响应 资源 -- 发回的汇率数据就是资源。

API端点?那是什么?

正如我们现在所知道的,计算机需要以非常精确的方式进行非常精确的输入。对计算机“像我们一样理解事物”的任何偏差或任何期望都会导致混乱!

本着这种精神,我们必须明白,即使是 API 请求也需要以一种非常精确的方式进行结构化。

API 的一般结构如下所示:

  • API 端点——这是接收请求的 URL。
  • 方法——这是 API 请求的类型,有多种类型,例如:
    • GET——表示请求正在寻找从服务器获取信息。
    • POST——表示请求正在寻找向服务器发送一些信息。
    • DELETE——表示请求正在寻找从服务器中删除一些信息。
    • PUT/PATCH——表示请求正在寻找更新服务器上的现有信息。
  • 标头——这提供了有关所请求资源的一些上下文。
  • 正文——这是触发响应的请求的主要部分。

CRUD 响应

CRUD 代表 Create、Read、Update 和 Delete,通过 API Request 中的相关 API 方法执行:

接口方法回复描述
get从服务器获取现有信息
post创造向服务器添加信息
delete删除删除服务器上的信息
put/patch更新更新服务器上的信息