什么是API
这篇文章主要为大家展示了“什么是API”,内容简而易懂,条理清晰,希望能够帮助大家解决疑惑,下面让小编带领大家一起研究并学习一下“什么是API”这篇文章吧。
什么是API?
我们只要是在进行编程我们就需要不停的设计API。
API简单来讲可以是一个调用的函数,一个接口。
抽象来说,接口是一个内聚系统暴漏给外部的一切信息,包含但不限于:
调用方式
比如通过lib库或者http接口等。
调用约定
比如lib的函数签名或者HTTP的参数,http method或者头信息,长短链接等等。
依赖关系
比如接口的调用需要涉及到第三方或者其他的准备工作等等。
API就像一个人一样,我们和一个API打交道的时候需要了解这个人的特性偏好等,有的人很好相处,而有的人让人很头疼,尤其是你不得不和他打交道的时候,和人一样,如果你不得不和他打交道,要改变他的秉性是很痛苦的,人的“本性难移”, API也一样,一旦发布了,要改变的成本就很大很大。
好的API应该具有:
易于学习
即使没有文档也易于使用。
不易误用
这一点很重要,要减少使用者的心智负担。
易于满足需求
API的完备性和正交性。能够容易的满足需求,完备性保证功能完整,正交性保证接口的简洁性,不需要为所有的需求提供接口,而是由用户去组合。
易于扩展性
怎么样设计良好的API?
专一
一个API的功能应该是单一的,需要能够很容易的解释和理解,也就会更好用。
尽可能的小
小有很多的优势,易于理解和维护。
尽量少的外部依赖
减少使用者的成本。
设计不被实现影响
不要暴漏实现细节给用户,竟可能少的暴露,不止是内部细节,对于不必要的接口尽量不要发布,比如使用不多的功能,可以暂时不暴露接口。
良好的命名
尽量做到自描述。
完善的文档
考虑性能
以上是“什么是API”这篇文章的所有内容,感谢各位的阅读!相信大家都有了一定的了解,希望分享的内容对大家有所帮助,如果还想学习更多知识,欢迎关注编程网行业资讯频道!
免责声明:
① 本站未注明“稿件来源”的信息均来自网络整理。其文字、图片和音视频稿件的所属权归原作者所有。本站收集整理出于非商业性的教育和科研之目的,并不意味着本站赞同其观点或证实其内容的真实性。仅作为临时的测试数据,供内部测试之用。本站并未授权任何人以任何方式主动获取本站任何信息。
② 本站未注明“稿件来源”的临时测试数据将在测试完成后最终做删除处理。有问题或投稿请发送至: 邮箱/279061341@qq.com QQ/279061341