转自 https://blog.csdn.net/cumtdeyurenjie/article/details/80211896#t2 和https://blog.csdn.net/weixin_38174062/article/details/80829912 非原创，为便于学习转载，侵权删。
阅读本文大概需要 5~6 分钟
大家可能最近经常听到 API 这个概念，那什么是API，它又有什么特点和好处呢？
wiki 百科镇楼
…[APIs are] a set of subroutine definitions, protocols, and tools for building application software. In general terms, it’s a set of clearly defined methods of communication between various software components.
翻译：API 是用于构建应用程序软件的一组子程序定义，协议和工具。一般来说，这是一套明确定义的各种软件组件之间的通信方法。（回来再看(。・∀・)ノ）。
本篇文章中，我会用浅显的比喻来解释API，接口（interface），协议（protocol）这些基本概念。enjoy it !
假设你有一个银行
你有一个仓库来存钱，一个记账本来记各种业务。一个简单的管理银行的方法是直接将权限给所有人，让客户自己动手完成各种业务。
这种模式下，一个客户想要存钱的话，他需要：
拿着钱去银行打开仓库把钱放进去把这笔业务写到记帐本上离开银行显然这存在着问题：
想开开仓库门需要废很大力气，并不是所有的人都能打开，还有些人不识字不会记账。在这个模式下，我们假定所有人都是诚实的，显然这并不成立。（说不定哪一个人存了100块钱记账的时候写了10000块）。这时你遇到麻烦了。
雇一个柜员要是我们雇一个体格棒，办事还麻利的人来处理开仓库，记账的问题呢？
坦率的小虾米登场了。
现在模式为：建一个柜台将仓库和记账本和顾客分开，这样顾客就不需要再去管仓库和记账本了。想存钱的话直接找坦率的小虾米就行。
这种模式下，要是有人想存钱，他们必须：
拿钱去银行告诉坦率的小虾米我是 MMM 我想要存￥￥￥。坦率的小虾米打开仓库把钱放进去坦率的小虾米把业务（transaction ）记录好告诉你业务办好了顾客离开银行现在不会发生打不开仓库门或者是记错账的情况了，你觉得很满意。
到此我们引出今天的主角API（ Application Programming Interface），它能够帮你实现轻松的和其他软件组件（如服务器，操作系统等）的交互。
在上面举的例子中，我们雇一个收纳员帮顾客解决了开仓门，放钱，记账这一系列繁琐的过程。这大大节省了顾客的时间，同时提高了银行的效率。同理，如果我们将操作的具体实施步骤抽象化，这将会大大降低开发人员的负担（去记忆所有的步骤花费的力气），从而大大提高了效率。
另外的好处是，只要他们遵循了同一个协议，组件可以交换或者是改变。银行不需要知道时哪一个顾客或者说顾客是怎么进来的，顾客也不需要知道银行拿自己的钱去做什么了。只要负责的柜员在这里并做好工作，整个流程将会继续工作。
API 应用范围很广：从操作系统中简单的 fork() 到我们接触的百度地图API，和风天气API，又或者是zxdgs分享的段子，这些 API 都大大简化了程序员的工作。
银行里有什么你可能已经注意到了银行分成了两个区域：顾客在前台排好队来办理业务，后台完成各种对钱的操作。在中间层，前台和后台发生了交互， 双方都不能越界 ，交互只能发生在中间的区域。
在 API 术语里面，我们管中间的这块区域叫做接口 Interface ；在这里各个部分发生交互。在我们的银行中，前台和后台都同意并且规定使用 Interface 来交换信息。
现在，我们假定 xddxl 想要取钱。他到了柜台找到了坦率的小虾米，坦率的小虾米知道该怎样去取钱，她取好了之后告诉了 xddxl。
xddxl 这时候又问：“你知道今天的股票行情吗”
坦率的小虾米：？？？？WTF ?
在这个例子里面，坦率的小虾米知道怎样取钱和存钱 , 但是她不知道如何去给xddxl查查今天的股票行情是怎样的。这个例子引出了另一个概念 协议（Protocol）。
在 API 术语中，协议 是规定了各部分之间如何进行交流的一系列规则的集合。各部分之间想要完成交互必须理解并且遵守同一个协议。
同时，我们注意到了交换时用的是中文。如果xddxl 对坦率的小虾米说「我想撳五百蚊出嚟呀唔該」，坦率的小虾米不懂广东话，所以没法理解xddxl说的是什么，这又引出了另一个概念 格式（Format）
在程序员的世界里，通用的格式包含 XML 和 JSON。
最后，让我们假设银行想要扩展业务到股市，这时候就需要一位特殊的接待员来处理与股票相关的业务了，这时，怕黑的香菇就登场啦。
在 API 术语里面， API 端点 通常是指在同一个接口中提供特定功能子集的服务提供者。在这种情况下，怕黑的香菇和坦率的小虾米都是端点。（怕黑的香菇和坦率的小虾米是同一个柜台不同功能的提供者）不同的端点可以有不同的协议和不同的格式。
总结起来：接口是不同组件进行交互的地方。协议是一系列规定了他们之间怎样进行交互的规则。格式定义了他们通过什么进行交流（JSON或者是XML），端点可以在同一个接口里面提供不同的功能。
柜员还能干什么？到现在我们把 API 的基础知识过了一遍，接下来我们再来谈一谈 API 的其他特征。w(ﾟДﾟ)w
现在又有客户来取钱了，他想要取￥10000。
首先，我们可以指示坦率的小虾米在操作前先去确认一下 xddxl 是否真的有这么多钱。（API 能确认所有的操作都是合法的。）
坦率的小虾米查到 xddxl 账户里只有一百块了，告诉 xddxl 余额不足。（在发生错误的时候 API 会根据错误报告机制发出指示，减轻开发人员的负担。）
xddxl 认为肯定是哪里出错了，他要求银行给他列一张表，给出他所拥有的每个账户上的余额。结果显示一共有 200 个账户。把他们一下子全给列出来不太实际，所以坦率的小虾米每次给 xddxl 看十个账户，看完了之后再来十个。（这叫做分页（pagination），可以节省带宽和服务器资源，因为你不需要一次获取数据集中的所有内容。）
如果 xddxl 只想要知道他某一个账户中的余额的话，他可以要求坦率的小虾米只给她看那个的（这称为过滤（filtering），它还有助于节省带宽和资源，并且更易于导航。）
在检查完所有账户之后，jsdmg现在知道他的帐户中确实没有10000美元。他知道无奈的宝马购买股票并获得了大量资金，于是伪装成无奈的宝马并重新进入银行。他告诉tmdmj：“我是无奈的宝马，我想从我的账户中提取10000美元。” 坦率的小虾米识破了他的骗局。（API中内置授权和访问控制，以确保只有授权人员才能访问特定数据。）
最后，在试图从银行拿到10000美元失败后，他想报复坦率的小虾米，他进入银行并多次从账户中提取0.01美元。 （我们可以实施速率限制来控制服务器资源的使用，以确保用户不会滥用服务。）
API 通常都会被设计具有这些功能，它可以充当防火墙，在保护您的资源免受滥用的同时允许合法请求通过。
再读Wiki…[APIs are] a set of subroutine definitions, protocols, and tools for building application software. In general terms, it’s a set of clearly defined methods of communication between various software components.
API 是用于构建应用程序软件的一组子程序定义，协议和工具。一般来说，这是一套明确定义的各种软件组件之间的通信方法。
现在是不是头脑里对这个概念清晰多了呢。
补充：
应用程序接口（API）是以编程语言提供的结构，允许开发人员更容易地创建复杂的功能。它们抽象出更复杂的代码，并提供一些简单的语法来使用。
来看一个现实世界中的例子：想想您的房子、公寓或其他住宅的电力供应，如果您想在您的房子里使用一个设备，您只需把它插入到一个插座中；您并不会直接把它连接到电源上 - 这样做效率会非常低，而且如果您不是电工，这么做将是困难和危险的。
同样，比如说，编程来显示一些3D图形，使用以更高级语言编写的API（例如JavaScript或Python）将会比直接编写直接控制计算机的GPU或其他图形功能的低级代码（比如C或C++）来执行操作要容易得多。
客户端JavaScript中的API
客户端JavaScript中有很多可用的API — 他们本身并不是JavaScript语言的一部分，却建立在JavaScript语言核心的顶部，为使用JavaScript代码提供额外的超强能力。他们通常分为两类：
浏览器API内置于Web浏览器中，能从浏览器和电脑周边环境中提取数据，并用来做有用的复杂的事情 。例如Geolocation API提供了一些简单的JavaScript结构以获得位置数据，因此您可以在Google地图上标示您的位置。在后台，浏览器确实使用一些复杂的低级代码（例如C++）与设备的GPS硬件（或可以决定位置数据的任何设施）通信来获取位置数据并把这些数据返回给您的代码中使用浏览器环境；但是，这种复杂性通过API抽象出来，因而与您无关。第三方API缺省情况下不会内置于浏览器中，通常必须在Web中的某个地方获取代码和信息。例如Twitter API 使您能做一些显示最新推文这样的事情，它提供一系列特殊的结构，可以用来请求Twitter服务并返回特殊的信息。API可以做什么？ 常见浏览器API操作文档的API内置于浏览器中。最明显的例子是DOM（文档对象模型）API，它允许您操作HTML和CSS — 创建、移除以及修改HTML，动态地将新样式应用到您的页面，等等。每当您看到一个弹出窗口出现在一个页面上，或者显示一些新的内容时，这都是DOM的行为。 您可以在在Manipulating documents中找到关于这些类型的API的更多信息。从服务器获取数据的API 用于更新网页的一小部分是相当好用的。这个看似很小的细节能对网站的性能和行为产生巨大的影响 — 如果您只是更新一个股票列表或者一些可用的新故事而不需要从服务器重新加载整个页面将使网站或应用程序感觉更加敏感和“活泼”。使这成为可能的API包括XMLHttpRequest和Fetch API。您也可能会遇到描述这种技术的术语Ajax。您可以在Fetching data from the server找到关于类似的API的更多信息。用于绘制和操作图形的API目前已被浏览器广泛支持 — 最流行的是允许您以编程方式更新包含在HTML <canvas> 元素中的像素数据以创建2D和3D场景的Canvas和WebGL。例如，您可以绘制矩形或圆形等形状，将图像导入到画布上，然后使用Canvas API对其应用滤镜（如棕褐色滤镜或灰度滤镜），或使用WebGL创建具有光照和纹理的复杂3D场景。这些API经常与用于创建动画循环的API（例如window.requestAnimationFrame()）和其他API一起不断更新诸如动画和游戏之类的场景。音频和视频API例如HTMLMediaElement，Web Audio API和WebRTC允许您使用多媒体来做一些非常有趣的事情，比如创建用于播放音频和视频的自定义UI控件，显示字幕字幕和您的视频，从网络摄像机抓取视频，通过画布操纵（见上），或在网络会议中显示在别人的电脑上，或者添加效果到音轨（如增益，失真，平移等） 。设备API基本上是以对网络应用程序有用的方式操作和检索现代设备硬件中的数据的API。我们已经讨论过访问设备位置数据的地理定位API，因此您可以在地图上标注您的位置。其他示例还包括通过系统通知（参见Notifications API）或振动硬件（参见Vibration API）告诉用户Web应用程序有用的更新可用。客户端存储API在Web浏览器中的使用变得越来越普遍 - 如果您想创建一个应用程序来保存页面加载之间的状态，甚至让设备在处于脱机状态时可用，那么在客户端存储数据将会是非常有用的。例如使用Web Storage API的简单的键 - 值存储以及使用IndexedDB API的更复杂的表格数据存储。常见第三方API
第三方API种类繁多; 下列是一些比较流行的你可能迟早会用到的第三方API:
The Twitter API, 允许您在您的网站上展示您最近的推文等。The Google Maps API 允许你在网页上对地图进行很多操作（这很有趣，它也是Google地图的驱动器）。现在它是一整套完整的，能够胜任广泛任务的API。其能力已经被Google Maps API Picker见证。The Facebook suite of API 允许你将很多Facebook生态系统中的功能应用到你的app，使之受益，比如说它提供了通过Facebook账户登录、接受应用内支付、推送有针对性的广告活动等功能。The YouTube API, 允许你将Youtube上的视频嵌入到网站中去，同时提供搜索Youtube，创建播放列表等众多功能。The Twilio API, 其为您的app提供了针对语音通话和视频聊天的框架，以及从您的app发送短信息或多媒体信息等诸多功能。