海阔凭鱼跃，天高任鸟飞。Hey 你好！我是秦爱德。😄 各位看官，好久不见，我又来了。今天我给大家带来一个好消息，我同事（老孟）的api接口管理工具终于开发完成，正式发布上线了。喜大普奔，秦爱德发来贺电yeah~~~ 曾多少个日日夜夜，看着日渐消瘦的老孟，一遍遍抓着为数不多的头…

最近为项目引入Swagger来支持自动生成文档功能，发现很多文章仅仅介绍了如何接入以及如何使用的问题。但是对于实际工程实践，并没有给出相应的最佳实践方案。因此，我重新梳理相关内容以及文档，整理出一套最佳实践指南。 在正式介绍之前，我们首先要了解Swagger和Springfox…

什么是API文档？API文档是一份可交付的技术内容，其中包含有关如何有效使用和集成API的说明。这也是一本简单明了的参考手册，编写了使用API所需的所有信息，以及有关功能、返回类型、参数等详细信息，并

随着互联网高速发展，公司对项目开发周期不断缩短，我们面对各种需求，使用原有对接方式，各端已经很难快速应对各种需求，更难以提高效率。于是，我们不得不重新制定对接规范、开发逻辑以便快速上线项目。 尽可能的缩小沟通的成本，开最少的会，确定大部分的事。 花最少的时间写文档，保证90%的…

Swagger / Open API 在Restful API 领域已慢慢成为标准，越来越多的系统使用swagger来规范开发接口文档，由于Swagger 本身并不依赖特定的语言和开发平台，所以特别合适作为前后端分离的接口标准来使用。 Swagger 官方提供了两种文档UI形式…