API优先战略的好处
在决定开始构建API时,作为项目规划阶段的一个组成部分,我们需要先回答一些关键问题。首先我们必须先确定构建API背后的两个要素:确定项目的目标受众到底是谁;我们针对使用者设定了什么样的目标。而在规划阶段确认了这两个要点之后,我们还可以看看,在进入设计阶段和创建API架构前这种策略到底那够给软件开发带来什么好处。
从零开始,轻装上阵
使用API优先的设计最明显的优势就是:不考虑任何现有的IT框架,创建API和基于他的应用程序将变得非常简单。借助API优先的策略,所有的项目参与者都可以基于精心构建的API,随时随地的进行沟通协作、设计和开发。这意味着开发过程将不受到任何限制,所有的IT基础架构都可以变化去适应API,而不是去改变API的标准,这让团队有了一个最基础的标准。通过这种方式,团队可以很轻松的进行API测试,并获得所有相关的反馈。这确保了最终产物是根据团队的设计初衷进行开发,并能够切实的为用户提供所需的服务。
高效统一
越来越多的企业和组织发现,想要提供一个可以在所有设备和平台上能够都顺利执行的程序是非常困难的,这是因为在我们的生活中也产生了越来越多的设备。API优先策略使得在API层之上构建单个应用程序成为了可能,这让企业在各种不同的平台上为各种应用程序提供服务的同时,能够高效的对兼容性进行支持。除了简化开发工作之外,这种方法也使得所有在平台上维护和更新应用程序的过程变得简单,而不需要企业考虑这是基于本地或者WEB端的移动或非移动平台。
快速易懂
这是API的基本特性之一。为了让API能够无缝使用,即使使用者没参与到API的创建当中,也应该很容易理解他的构成。要达到这一特性,就意味着有着清晰而全面的接口文档,以供使用者快速理解和使用。
API优先的策略可以非常轻松的呈现结构化文档,文档中应当按照资源类型、标题、请求参数、响应格式等的模式进行标准化撰写,这让使用者在查看API文档和理解其功能时更加的容易。
而除了遵循标准化的格式之外,“API优先”的设计方法可以在不可避免的情况下,清楚地记录与标准情况的偏差情况,以便让团队更好的解决潜在的问题。