最近写了几天RAML的接口文档,觉得确实有一定的成本。如果只是为了一个文档成本确实有点高,我觉得我们应该挖掘下RAML这个文档的潜力:

设计阶段

设计阶段建议在项目未开始之前就进行完,推荐使用atom+raml插件来进行 atom

开发阶段

传统开发阶段前后端分离,各干各的,通过需求和接口文档 进行连接。但前端的功能无法测试,过后还需要漫长的联调时间。我们现在可以通过raml生成一台Moke服务器,让前端在开发开始阶段就可以调用到基于接口文档实现的HTTP接口

atom

测试阶段

传统测试阶段要么是等前后段联调完后测试前端功能连带测试服务器的业务,要么就是能力高一点的可以自己看明白接口文档使用postman之类的工具自行测试服务器接口。

新的方式可以直接导入写好的接口文档,不用再手工写调用请求,可以直接选择接口填入参数进行请求。也可以批量测试所有接口。 interface

interface

文档留档

最后的最后肯定就是留存了

interface

未来

想继续通过这个raml能实现自动化的每日接口测试。

raml



如果觉得文章内容比较实用,期望获得更新通知,请关注公众号:

guohaiqr.jpg