企业应该采起文档优先的方法来开发API。虽然测试驱动的开发强调编写设计良好的代码,但文档驱动的开发考虑了API的可用性。api
由文档驱动的API开发使开发团队在实际编写一行代码以前就能够考虑从验收标准到UI和用户体验的全部内容,可是,它可能会减慢初始开发周期。在这些文档驱动的开发人员构建API以前,依赖于使用新设计的API的团队可能会受阻。服务器
因为生产力在企业中相当重要,所以工程团队须要消除软件开发的障碍。在缺乏API的状况下,团队应尽早使用MockAPI来验证文档以及后续的实现和集成。顾名思义,MockAPI本质上是一个虚拟的API,它接受示例请求并返回有效响应,所以开发人员可使用非生产的API。
工具
尽管有些团队在内部构建和创建Mock服务器,用于减小代码并提升生产率,但某些选定的第三方工具(例如Eolinker)能够轻松,高效地建立MockAPI。在API模拟过程当中,文档必须与Mock服务器保持同步。
测试
Eolinker是标准的API管理工具。基于RESTfulAPI的文档规范使开发人员可以以简洁而富有表现力的方式来文档化API,并自动生成MockAPI。
url
为了更好地说明文档标准(如Eolinker)对于文档验证的价值,让咱们使用一些基本的API文档和API工具建立MockAPI。翻译
首先,建立一些文档。对于任何文档驱动的开发项目,需包括如url,参数,响应和验证之类的信息。例如,如下是简单的用户登录API文档的规范:
设计
生成API文档后在MockAPI填写指望信息。
blog
调用MockAPI的url,设置指望参数便可测试并用于开发。
生命周期
使用MockAPI进行文档驱动开发的简单示例显示了此方法的重要做用。借助功能丰富的API文档工具,开发人员能够设计合理、逻辑清晰的API,而不会破坏典型的产品开发生命周期。
翻译:Eolinker
演示工具:www.eolinker.com开发