SosoApi,编辑Swagger UI的神器

        对于IT码农来说API文档是再熟悉不过的东东。特别是API文档的编辑和交流更是相当的虐心。

        就个人来说,使用过编辑API文档的工具,从最原始的口口相授,到接下的苦逼word和上个项目在用的dokuwiki,没有一个让自己很满意的。要么是编辑太麻烦,升级时还要传来传去,如word,要么及时可以在线编辑吧,又得去熟悉相关的编辑语法,如wiki。更要命的是有时一个接口明明自测是可以的,然后有一天前端人员跑过来跟你说,接口调用失败,这个时候别提有多郁闷了。因为你要根据接口文档在rest工具上重新跑一遍,测下接口是否真的用不了,参数少点还好说,有时好几个参数就更繁琐了。每当这个时候,就总在想,如果有一个工具既可以当api接口文档来看,也可以直接测试,马上看到结果,那无论对于前端还是后端都是爽歪歪的。

        偶尔一个机会在一个技术交流群里看到有人提到有个api工具挺好用的,swagger ui。当即上网搜索了下,用的人还蛮多的,于是到其官网小逛一下。这一逛可把我乐开了花,这不是我正一直苦苦找寻的吗?界面简单明了,功能强大,可直接在线表单式测试接口(具体效果可以看文章末尾)。于是,我就兴冲冲的下载,看说明文档,写demo。前前后后总共折腾了2天,后来发现使用上还是有些许的不方便。主要有2点,其一,集成使用上,要么通过服务端代码嵌入,这样就跟业务代码偶尔在一起了,而且无法单独部署;要么手动编写对应的json格式文档,文档结构又比较复杂,而且无法多个人协助。其二,如果是手动编辑json文档的话又不支持自定义格式,只能一次一层还不能嵌套,蛋疼不已。

        我个人是觉得,文档就是文档,最好不要跟业务代码耦合在一起,于是一开始就摈弃了服务端集成方式,就想着看下有没什么简便的方法来编写json格式文档。本来有打算写个小工具以表单的形式来编辑,这样就爽多了。可惜只是想想而已,后来其他事忙着,也就没去再想这个事。

        很凑巧,又在一个群里看到有位哥们在推广他的网站SosoApi(www.sosoapi.com),说是专注于API接口管理和线上线下测试的,而且刚好又是用的SwaggerUI。于是,很好奇的点击进去一探究竟,看下是怎样一个网站,名字还这么奇怪,soso。。。不用不知道,一用吓一跳,这不就是专门为我写的吗?编辑起Swagger UI的json文档那是相当轻松啊,而且不但可以在线预览还可以下载到本地部署。估计网站的攻城狮也觉得API文档还是本地比较保险比较安全吧。这个必须赞一个。

        虽然好久不写技术blog了,不过,这个网站确实不错,有在用SwaggerUI的同行或打算从原来API接口文档的苦逼中跳出来的确实可以试着用下。


SosoApi,编辑Swagger UI的神器_第1张图片
 
SosoApi,编辑Swagger UI的神器_第2张图片
 

 

你可能感兴趣的:(UI,swagger,swagger,API接口,api文档,sosoAPI)