【Web Design The Missing Link】Conclusion

近年来，随着Web API在商业上的重要性日益提高，Web API设计的最新水平和创新步伐不断提高。

Web API基于万维网技术，特别是在HTTP和URI规范。 设计Web API时，最好将自己尽可能地限制在那些规范中能找到的概念和技术，这可以最大程度地减少客户端必须学习的特定于您的API的数量。HTTP和URI内在的概念是面向实体的，因此，以这种风格设计API更像是设计数据库，而不是设计典型的编程语言API。想法是专注于您的数据，仅让HTTP提供统一的API，就像数据库管理系统提供统一的API一样，而不管数据库是什么。
采用面向实体的方法要求程序员在API模型与其代码之间创建映射，这增加了一些负担。 付出的额外努力包括Web API的简单性和统一性，以及事实证明这种方法在维持客户端和提供者之间的松散耦合方面非常成功，这是好的API的最重要和难以捉摸的特征之一 。

由于Web-API内部是面向数据的，因此设计API的大部分工作都应归入数据格式的规范。HTTP为每个Web API的基本CRUD部分提供了一个标准API，但是对于如何表达对数据的查询，它没有太多的表达。 这就是为什么在表示查询的URL设计中通常要进行大量设计工作的原因。 我们已经提出了一些有关如何构造这些查询API的想法，以最大程度地减少客户端的学习工作并增加不同API之间的通用性。

直到最近，API中链接的使用主要是由一个对通用客户端兴趣小社区提倡的，该通用客户端对任何特定的API都不具有先验知识，就像Web浏览器没有任何特定网站的先验知识。最近，我们看到了很多对API链接的价值的赞赏。

身份验证，错误表示和SDK是API设计中的其他主题，我们试图在这些主题上提供一些指导。 版本控制仍然是一个观点各异的话题，但是最近对根本不执行任何操作的选择进行了更多讨论。 事实证明，此选项非常合理，并且适用于许多API，包括我们自己的API。