【Web Design The Missing Link】Web API and REST

API 设计者的工作

API的工作是使应用程序开发人员尽可能地高效。在制作API时，您应该从应用程序开发人员的角度考虑设计选择。

为什么？ 看看下面的价值链。 应用程序开发人员是整个API策略的关键。编写API时，主要的设计原则应该是最大程度地提高应用程序开发人员的生产力和成功率。

正确设计很重要，因为设计可以传达如何使用某些东西。 那么问题就变成了：对应用程序开发人员来说，利益最大化的设计是什么？
 

什么是web API？

Web API是HTTP请求和响应的模式，且专门用于由任意的应用程序内部访问的模式准则，而非人们访问浏览器的准则。

什么是REST？

REST是HTTP本身架构风格的名称，由HTTP规范的主要作者之一描述。HTTP是现实规范、REST是塑造它的一组设计思想。

从实用的角度来看，我们可以将注意力集中在HTTP以及如何使用它开发API上。REST的意义在于它启迪我们如何去思考HTTP,以及如何如何使用HTTP。

有一些Web API设计仅使用HTTP的概念。大多数现代API使用HTTP中一些概念的子集，并与其他计算技术中的一些概念相融合。

例如，许多Web API是根据具有参数的终端定义的。 终端和参数不是HTTP或REST固有的术语或概念，它们是从远程过程调用（RPC）和相关技术继承而来的概念。RESTful一词是针对Web API的，它比以前的技术使用了更多的HTTP内部的概念和技术，但也融合了其他概念。这样设计了许多好的API，并且实际上，这种混合样式可能是最常用的API样式。HTTP和REST的概念是精确定义的，但术语RESTful并不是，它是属于“当我看到它时便知道”的这类概念。

我们并不是为了纯粹地去了解HTTP和REST，重要点在于API的有效性，但我们也认为，在所有其他条件相同的情况下，最好在HTTP之外添加尽可能少的概念。如果这样做，随着时间的流逝，您的API的独特功能将越来越少。

这种信念实际上是对 Occam’s razor 最基本概念的一种表达，即使用最少数量的概念来解决问题。 引用圣艾修伯里的安托万（Antoine de Saint-Exupery）的话：

“完美境地,非冗杂,而不遗”。

除了概念上的极简主义之外，还有其他原因会影响我们对Web API的HTTP概念的认识。分布式API的设计人员力争的最重要特征之一就是最大程度地减少客户端和服务器之间的耦合。耦合的度量是在不破坏另一侧的情况下改变一侧的容易程度。在API设计中，最小化耦合是最困难的事情之一。HTTP在这方面的成功记录可能是前所未有的。考虑到Web仍然支持20年前编写的HTTP客户端，这表明HTTP将客户端与服务器分离的效果是显著的。 在解耦合上HTTP是如何达到此级别的分析和说明一直是REST论文的重点之一，而解耦是首先对HTTP作为API平台的主要原因之一。在HTTP之上组合其他模型（类似RPC）存在争议的原因之一是，它们倾向于破坏HTTP设计的松散耦合质量。 这是仅使用HTTP的另一个重要原因.

在本书的其余部分，我们将探讨如何仅使用HTTP的固有概念来设计Web API。 我们使用REST API一词来表示具有这种效应的Web API。