AskELI5

计算与网络

API如何工作

API让一个软件向另一个软件请求帮助。

在餐厅里，你不会走进厨房，而是向服务员提出菜单允许的请求。厨房完成工作后，服务员再把结果送回来。

  1. 两个独立的软件程序，中间有一个等待传递的请求。客户端应用需要天气数据天气服务知道天气预报

    步骤 1

    两个程序需要对话

    一个程序需要数据或操作，而另一个程序知道如何提供它。

  2. 餐厅服务员如同API，在客户端与服务之间传递请求。餐厅服务员=API

    步骤 2

    API就像服务员

    API规定如何提出请求，并把请求方程序与实际工作的系统分隔开。

  3. 一个API请求分为端点、方法、详细信息和凭证。端点方法详细信息凭证

    步骤 3

    请求要按照菜单

    客户端选择端点，并发送所需的方法、详细信息，有时还要提供凭证。

  4. 请求进入服务器，经检查和处理后变成结果。检查请求执行工作准备结果

    步骤 4

    服务器处理请求

    服务器检查请求，运行自己的逻辑，然后准备结果。

  5. 服务器响应携带状态和数据，返回客户端应用。服务器状态和数据客户端应用

    步骤 5

    响应返回客户端

    API返回数据和状态，客户端再决定接下来显示什么或做什么。

  6. 请求分支为成功、缺失、禁止和失败的API响应。成功请求的数据有用的状态错误失败的内容有用的状态

    步骤 6

    错误也是响应

    如果请求缺失、被禁止或无法完成，API会返回说明失败类型的状态。

常见误区

API就是服务器或数据库本身。

API是提出请求时共同约定的接口，服务器及其数据位于这个接口之后。

快速检查

在餐厅类比中，哪一部分像API？

  1. 服务员
  2. 餐桌
  3. 顾客的鞋子
查看答案

服务员把允许的请求送到厨房，再把结果带回来。

资料来源

  1. Introduction to web APIsMDN Web Docs
  2. What is an API?IBM
  3. What is a REST API?Red Hat