Swagger最佳实践
文章平均质量分 61
最好用的API管理工具!在这里,分享关于Swagger的最佳实践!
henry-hacker
你好,世界!
展开
-
Swagger-Codegen的简单使用
前言 说句实在话,丝袜哥(Swagger)为我们提供了非常多的工具,其中最强的还要算这个代码的生成工具了。啊哈哈,下面,就和阿福一起来看看怎么用吧! 实际上我们都知道,在当今这个前后端分离的大环境下,前后端之间订立的接口契约就显得尤为重要,中国不是有一句古话讲的好吗,君子一言,驷马难追,而契约也大抵如此,也就是说契约在订立之后变动的可能性已经很小,这就要求我们提前的去原创 2017-05-12 22:11:09 · 20630 阅读 · 2 评论 -
Spring结合Swagger实现API管理
前言 在日常的开发过程中,再进行前后端协作的过程中,遇到的API管理方式简直是多不胜数啊!而且大家还都是各有特点,比如说word书写的文档,markdown书写的,什么,你说你用记事本写,这个倒还真的是莫有见过。总的来说就是大家对于API文档压根很不重视。还有一点,我记得我当初在做重构的时候,那时候已经是2016年了,但是文档相关的接口的文档还停留在2014年好吗?主要的问题是那个时候原创 2017-04-23 16:11:30 · 1899 阅读 · 0 评论 -
Swagger-Editor开发环境搭建
前言 上一篇文章我们有提到Swagger做接口的定义是采用yaml语言的,当然,yaml是个啥,大家自行百度。阿福在此不做赘述了。但是,今天我们要来讲的是yaml支持比较好的Swagger-Editor开发环境的搭建。环境准备 实际上,Swagger-Editor是基于 NodeJs 开发的,那么,就一定是需要Node的开发环境的啦!安装最新版的Node。直接去到Node原创 2017-03-28 18:55:57 · 8514 阅读 · 10 评论 -
漫谈api管理-Swagger
前言 事实上,API的管理和书写对于开发人员而言一直都是一件异常痛苦的事情,但是那只是我知道和听闻而已。可是最近自己负责的几个项目的或重构或新开发的过程中也遇到了非常多的问题,实在有些恼人。于是就在网上找了下看看有没有API管理的神器。诶,你别说,当我看到Swagger的时候,我感觉我被迷住了。是真的被迷住了。下面,我们一起来看看Swagger是个什么东东吧!Swagger是什么原创 2017-03-26 09:40:22 · 2516 阅读 · 0 评论