什么是API

这篇文章主要为大家展示了“什么是api”，内容简而易懂，条理清晰，希望能够帮助大家解决疑惑，下面让小编带领大家一起研究并学习一下“什么是API”这篇文章吧。

什么是API？

我们只要是在进行编程我们就需要不停的设计API。

API简单来讲可以是一个调用的函数，一个接口。

抽象来说，接口是一个内聚系统暴漏给外部的一切信息，包含但不限于：

• 调用方式

  比如通过lib库或者Http接口等。

• 调用约定

  比如lib的函数签名或者HTTP的参数，http method或者头信息，长短链接等等。

• 依赖关系

  比如接口的调用需要涉及到第三方或者其他的准备工作等等。

API就像一个人一样，我们和一个API打交道的时候需要了解这个人的特性偏好等，有的人很好相处，而有的人让人很头疼，尤其是你不得不和他打交道的时候，和人一样，如果你不得不和他打交道，要改变他的秉性是很痛苦的，人的“本性难移”, API也一样，一旦发布了，要改变的成本就很大很大。

好的API应该具有：

• 易于学习

  即使没有文档也易于使用。

• 不易误用

  这一点很重要，要减少使用者的心智负担。

• 易于满足需求

  API的完备性和正交性。能够容易的满足需求，完备性保证功能完整，正交性保证接口的简洁性，不需要为所有的需求提供接口，而是由用户去组合。

• 易于扩展性

怎么样设计良好的API？

• 专一

  一个API的功能应该是单一的，需要能够很容易的解释和理解，也就会更好用。

• 尽可能的小

  小有很多的优势，易于理解和维护。

• 尽量少的外部依赖

  减少使用者的成本。

• 设计不被实现影响

  不要暴漏实现细节给用户，竟可能少的暴露，不止是内部细节，对于不必要的接口尽量不要发布，比如使用不多的功能，可以暂时不暴露接口。

• 良好的命名

  尽量做到自描述。

• 完善的文档

• 考虑性能

以上是“什么是API”这篇文章的所有内容，感谢各位的阅读！相信大家都有了一定的了解，希望分享的内容对大家有所帮助，如果还想学习更多知识，欢迎关注编程网精选频道！