网页调用api接口 api什么意思( 三 )


应用编程接口Twitter API是一个基于web的JSON API,它允许开发人员以编程方式与Twitter数据进行交互 。与Java开发工具包中包含的Java API不同,Twitter API是一个基于web的API 。你必须通过互联网向Twitter托管的服务发出请求才能访问它 。
使用基于web的API(比如Twitter ),您的应用程序将发送HTTP请求,就像Web浏览器一样 。但是对于人类的理解来说,响应并不是以网页的形式传递的,而是以应用程序容易解析的格式返回的 。为此,有各种格式 。Twitter使用一种流行且易于使用的格式,称为JSON 。
Twitter的基本元素之一是tweets 。Twitter API告诉你可以用tweets做什么:搜索tweets,创建tweets,收集tweets 。它还告诉您如何执行这些操作 。要搜索推文,您需要指定搜索标准:您要查找的术语或主题标签、地理位置、语言等 。
API设计API设计者制定API的“内容”和“方法”的过程 。和其他任何可以创造的东西一样,API设计中的思路和程度不同,导致API质量程度不同 。一个设计良好的API具有一致的行为,考虑到它的上下文,并且牢记用户的需求 。
API中的一致行为很大程度上影响了它的学习速度和程序员在使用时出错的可能性 。一般来说,执行类似操作的API应该表现类似,不管它们在技术上有什么不同 。作为API不一致的一个例子,让我们来看看向Java中国列表添加项目的两种方法:
尽管向列表中添加条目的两种方法做了同样的事情,但是它们的返回类型(boolean和void)是不同的 。使用该API的开发人员现在必须跟踪哪个方法返回哪个类型,这使得该API更难学习,其使用也更容易出错 。这也意味着使用这些方法的代码变得不太灵活,因为如果你想改变添加元素的方式,它必须改变 。
考虑上下文是一致性的另一种形式,尽管它与API之外的因素有关 。一个很好的非软件例子是道路规则(右侧通行或左侧通行)如何影响不同国家的汽车设计 。汽车设计师在将驾驶座放在汽车的右侧或左侧时,会考虑环境因素 。
在API设计中,考虑上下文通常意味着您遵循普遍接受的最佳实践,并从您的用户可能熟悉的其他API中获取灵感 。假设您正在构建一个库,它为Java应用程序提供了一种新的列表,这种列表可能是专门为处理非常大的列表而设计的 。这个列表的API应该包含一个add方法,其行为方式与Java List add方法相同 。这样,用户可以很容易地采用你的库,因为他们已经知道如何使用它 。
在API设计中,了解用户并牢记他们的需求是至关重要的 。如果你理解他们的痛点,帮助他们避免这种痛苦,那么你的API就会有快乐的用户 。出于同样的原因,您可能会选择打破良好的API设计的其他规则 。如果你正在编写一个Web API,今天事实上的标准是使用JSON作为交换格式 。然而,如果您的API将服务于检索大量数据的科学用户,那么JSON将过于冗长和乏味,无法很好地为他们服务 。因此,您可能会选择使用像GRIB这样的二进制格式,尽管从一般意义上来说这是一个非常不寻常的选择 。
API是软件设计的重要组成部分,存在于软件栈的每一层 。它们提供了一种定义和管理抽象的方法,告诉我们可以用软件组件做什么以及如何做 。设计良好的API支持高效、流畅和容易的采用和使用,而设计不佳的API往往每次使用都会令人头疼 。
摘要API是一组用于构建应用软件的子程序定义、协议和工具 。一般来说,这是各种软件组件之间的一组定义良好的通信方法 。
【网页调用api接口 api什么意思】