什么是API，不同場(chǎng)景中的API

API（Application Programming Interface）有點(diǎn)類似于肯德基汽車穿梭窗口。但在代碼中，它們接受輸入并提供可預(yù)測(cè)的輸出。

在其核心，API是一組接受輸入并給出輸出的代碼

大多數(shù)現(xiàn)代應(yīng)用程序（如Excel）都是一堆API組成的

有時(shí)，公司會(huì)公開他們的部分API，比如Twitter或谷歌地圖

API是軟件中比較令人困惑的概念之一，因?yàn)樗鼈兛梢源砗芏嗖煌臇|西

API為大多數(shù)現(xiàn)代軟件開發(fā)提供了強(qiáng)大的功能，且是可以聰明地討論代碼的關(guān)鍵部分。

什么是API（理論上）？

如果你想理解API，需要進(jìn)行一個(gè)重要的區(qū)分：一個(gè)是API的技術(shù)定義，然后是人們?cè)趯?duì)話中如何實(shí)際使用這個(gè)概念。它們非常不同，這就是為什么這些東西會(huì)讓人很困惑。讓我們先來(lái)解決技術(shù)定義。

API是一組接受特定輸入并給出特定輸出的邏輯。幾個(gè)例子：

如果向谷歌地圖API提供一個(gè)地址作為輸入，它的輸出是該地址的經(jīng)緯度坐標(biāo)

如果給Javascript Array.Sort API一個(gè)數(shù)組作為輸入，它將這些數(shù)字作為輸出進(jìn)行排序

如果你給Lyft Driver API一個(gè)起始地址和結(jié)束地址作為輸入，它會(huì)找到最匹配的司機(jī)作為輸出

當(dāng)工程師構(gòu)建代碼模塊來(lái)做特定的事情時(shí)，他們清楚地定義了這些模塊的輸入和輸出：這就是API的真正含義。當(dāng)你給一個(gè)API一堆輸入來(lái)獲得你想要的輸出時(shí)，它被稱為調(diào)用API。 輸入 API通常會(huì)確切地告訴你它需要什么樣的輸入。如果你嘗試用你的名字作為谷歌地圖API的輸入，那不會(huì)有什么效果；它被設(shè)計(jì)用來(lái)完成一個(gè)非常特定的任務(wù)（將地址轉(zhuǎn)換為坐標(biāo)），因此它只處理非常特定類型的數(shù)據(jù)。有些API在輸入方面非常麻煩，并可能要求你以特定的方式格式化該地址。 輸出 就像輸入一樣，API給你特定的輸出。假設(shè)你為谷歌地圖API提供了正確的輸入（一個(gè)地址），它將始終以完全相同的格式給你回饋?zhàn)鴺?biāo)。還有非常具體的錯(cuò)誤處理：如果API不能找到你輸入的地址的坐標(biāo)，它會(huì)告訴你確切的原因。 這些都是技術(shù)和理論上的東西。 那些應(yīng)用只是API的集合 關(guān)于現(xiàn)代軟件，最值得理解的一點(diǎn)是，你最喜歡的那些應(yīng)用只是一堆API，上面有一個(gè)漂亮的界面，稱為前端。你使用的大多數(shù)應(yīng)用都是建立在這種前端/后端范例之上的。 后端 公司從為用戶在應(yīng)用中需要做的所有重要事情構(gòu)建API開始。對(duì)于Gmail，Google從接收、顯示、發(fā)送和轉(zhuǎn)發(fā)郵件的API開始；但這些都是通過(guò)代碼調(diào)用的。這些API以及使用它們的時(shí)間和方式的邏輯是應(yīng)用的后端。就像汽車引擎蓋下正在發(fā)生的事。如果你聽說(shuō)過(guò)后端工程師，那就是主要處理這些內(nèi)部組件的開發(fā)者。 前端 所有這些后端API只能通過(guò)代碼來(lái)使用，這并不是你想在iPhone上查看電子郵件時(shí)遇到的情況。這就是為什么公司要為他們的應(yīng)用創(chuàng)建前端：圖形用戶界面使應(yīng)用美觀且可用，而不需要編寫代碼。下面是Gmail中的工作方式：

你的收件箱顯示一排排的電子郵件和主題行：前端將這些后端的電子郵件數(shù)據(jù)進(jìn)行了很好的格式化處理

你可以點(diǎn)擊星形圖標(biāo)來(lái)標(biāo)記一封郵件：在后端，這將觸發(fā)一個(gè)“標(biāo)記郵件”的API

前端的大多數(shù)交互都被轉(zhuǎn)換成后端的API調(diào)用，這就是應(yīng)用軟件101。一旦我開始理解這個(gè)模型，就更容易理解開發(fā)者如何在對(duì)話中實(shí)際使用“API”的方式了。

什么是API（實(shí)際上）？

實(shí)際上，我發(fā)現(xiàn)人們?cè)谌N不同的場(chǎng)景中使用“API”，它們都代表著不同的東西。但從理論上講，它們都是一樣的，符合我們之前的定義。它們都是一樣的，但又有所不同。

公司內(nèi)部API

當(dāng)公司構(gòu)建他們的應(yīng)用時(shí)，他們把它們?cè)O(shè)計(jì)成一組交互的API。最容易理解的例子是Lyft（或者Uber）。你可能想在Lyft應(yīng)用中做一些事情，它們?cè)谀缓蠖紩?huì)觸發(fā)不同的API。

這種模式幾乎適用于你使用的所有應(yīng)用：你在應(yīng)用中采取的操作將觸發(fā)公司內(nèi)部API，這些API實(shí)際上完成了讓你的請(qǐng)求得到滿足的工作。公司內(nèi)部API也是分層的：雖然可能有一個(gè)廣泛的“預(yù)約乘車”API，但在這個(gè)“引擎蓋”下有一堆較小的API來(lái)完成它：查找司機(jī)、預(yù)約司機(jī)、驗(yàn)證信用卡、與用戶溝通等。

公共API

Lyft的API都不是公開的：它們只是Lyft在后端為你提供服務(wù)的方式。但有時(shí)，公司會(huì)提供一些他們的API，并告訴你如何使用它們。Twitter的API就是一個(gè)很好的例子。

通常，你使用Twitter應(yīng)用，它會(huì)對(duì)Twitter內(nèi)部API進(jìn)行一些API調(diào)用，比如顯示提要、發(fā)送回復(fù)和搜索（這就是我們剛剛談到的：前端和后端）。但你也可以在Twitter應(yīng)用之外通過(guò)代碼調(diào)用這些API。例如，有一個(gè)抓取用戶時(shí)間軸的API，你可以使用它來(lái)查看用戶的時(shí)間軸（他們的推文），該API以JSON格式返回那些推文，這是一種特殊的文本格式。

這些公共API讓人們?cè)赥witter上構(gòu)建應(yīng)用。有一些非?；镜臇|西，比如筆者做的這個(gè)學(xué)校項(xiàng)目，收集關(guān)于紐約大學(xué)的推文，分析他們的情緒，但也有一些相當(dāng)高級(jí)的東西，比如Flock，它可以讓你搜索你的訂閱者。

代碼接口

我們剛剛看到的前兩類API都是功能性的，它們通常完成一些實(shí)用且容易理解的事情，比如提供坐標(biāo)或預(yù)訂乘車。但是開發(fā)者也使用“API”來(lái)指代更底層級(jí)別的輸入和輸出，比如代碼中的函數(shù)。

Javascript的array.sort()方法就是一個(gè)很好的例子。它是一個(gè)接受數(shù)字或字母列表作為輸入的API，然后對(duì)它們進(jìn)行排序，并將它們作為輸出返回給你。還有其他與數(shù)組相關(guān)的API，比如添加（array.push）和移除（array.pop）東西，過(guò)濾（array.filter），以及獲取數(shù)組的大?。╝rray.length）。當(dāng)你用Javascript的時(shí)候，你會(huì)用到這些。

因此，當(dāng)人們談?wù)揂PI時(shí)，我們并不總是清楚人們到底在談?wù)撌裁?，特別是因?yàn)殚_發(fā)者用這個(gè)詞指代很多不同的東西。如果你感到困惑，就直接問(wèn)。答案很可能屬于這三類。

編輯：黃飛