1. Swagger（俗称：丝袜哥）是什么东西？Swagger 是一个规范和完整的框架，用于生成、描述、调用和可视化 RESTful 风格的 Web 服务。总体目标是使客户端和文件系统作为服务器以同样的速度来更新。文件的方法，参数和模型紧密集成到服务器端的代码，允许API来始终保持同步。Swagger 让部署管理和使用功能强大的API从未如此简单。2.丝袜哥 …
技术文章
前后端接口联调需要API文档，我们经常会使用工具来生成。之前经常使用Swagger来生成，最近发现一款好用的API文档生成工具smart-doc, 它有着很多Swagger不具备的特点，推荐给大家。聊聊Swagger在我们使用Swagger的时候，经常会需要用到它的注解，比如@Api、@ApiOperation这些，Swagger通过它们来生成API文档。比 …
最近简单的学习了一下Golang，并且用Gin开发了两个小应用，一个短域名生成，一个微信小程序。感受到了Golang的代码简洁、部署简单、内存占用少、零停机平滑重启等优势。在开发小程序的时候，需要生成接口文档，这里需要用到Gin-Swagger了，所以简单的就来整理一下。这里我用的环境是：go version go1.14.6 windowsamd64GoL …
本文出自《愚公要移山》收录于《Springboot专题》中这种整合的文章确实已经烂大街了，写他一方面是补充我的springboot系列，另一方面确实还有一部分小伙伴没用过。最重要的是，如果你忘记了这种整合的代码。可以随时查阅。前言现在的开发基本上都是前后端分离，前后端交互都是通过API文档。有了API文档大家各自开发，互不干扰。1、传统方式传统方式是文档设计 …
大家好，又见面啦。在前一篇文档《JAVA中自定义扩展Swagger的能力，自动生成参数取值含义说明，提升开发效率》中，我们探讨了如何通过自定义注解的方式扩展swagger的能力让Swagger支持自动从指定的枚举类生成接口文档中的字段描述的实现思路。其实swagger作为一个被广泛使用的在线接口文档辅助工具，上手会用很容易，但想用好却还是需要一定功夫的。所以 …
作者 | 唯一浩哥来源 | urlify.cnYJ3AFn前言早前笔者曾经写过一篇文章《研发团队,请管好你的API文档》。团队协作中,开发文档的重要性,这里就不再赘述,今天的话题集中在如何进一步提升更加高效的使用文档。离线文档swagger已经很方便了,我们为什么还需要离线文档?公司同一个项目组,一般只要集成了swagger基本就够了,但是难免会有跨组,甚至 …
介绍knife4j是为Java MVC框架集成Swagger生成Api文档的增强解决方案（在非Java项目中也提供了前端UI的增强解决方案），前身是swagger-bootstrap-ui,取名knife4j是希望她能像一把匕首一样小巧,轻量,并且功能强悍!开源仓库Githubhttps:github.comxiaoyminswagger-bootstrap …
作者：最美分享Coder来源：http:39sd.cn9D85F一、介绍knife4j是为Java MVC框架集成Swagger生成Api文档的增强解决方案（在非Java项目中也提供了前端UI的增强解决方案），前身是swagger-bootstrap-ui,取名knife4j是希望她能像一把匕首一样小巧,轻量,并且功能强悍!二、开源仓库Githubhttps …
进入 https:swagger.iodocsswagger-tools 这个网址，可以看到，文档的编写可以有远程和本地两种方式：远程集成本地集成基于node.js、npm、http-server， 如果还没有安装node环境的同学可以参考 Node安装教程。npm install -g http-server 安装 http-serverwget http …
0x01 工具简介Autoswagger 是一个命令行工具，用于发现、解析并测试使用 SwaggerOpenAPI 文档的未授权端点。它有助于识别 API 中未受保护端点的潜在安全问题，例如个人身份信息泄露和常见的密钥暴露。0x02 工具使用安装安装依赖项pip install -r requirements.txt检查安装，显示帮助：python3 aut …