2025年04月11日
作为拥有十年经验的软件项目经理，我深知接口文档编写的痛点：开发团队抱怨格式混乱，测试人员吐槽更新滞后，产品经理追问“参数说明在哪？”……今天给大家推荐一款能终结这些烦恼的开源神器——
2025年04月11日
在使用 postman 做接口测试过程中，测试工程师会往界面中填入非常多的参数，包括 url 地址，请求方法，消息头和消息体等一系列数据，在请求参数比较多的情况下非常花时间。
2025年04月11日
目前大部分的项目都是前后端分离的，后端除了要提供接口外，还需要提供接口文档，有时由于需求、设计或方案的变更，会造成接口变更但是接口文档没有及时更新的情况。Swagger是一个在你写接口的时候帮你自动生成接口文档，并且文档会随着接口的变化而变化的东西，只要你遵循它的规范并写一些接口的说明注解即可。
Swagger是一个规范和完整的框架，用于生成、描述、调用和可视化RESTful风格的Web服务的接口文档。下面我们通过一个实例来看一下Swagger的使用。
2025年04月11日
将SWAG风潮作为设计核心的潮流品牌GAWS近日释出2016年春季Lookbook，设计师把美国嘻哈风格服饰与时下流行的细节相结合，以黑、白为基调，在服饰上融入了许多宗教风格图案以及抽象几何图形，打造出球服风T恤、长款连帽卫衣、太空棉棒球夹克、字母织带外套、两件式短裤+打底等款式，辅以金属拉链的装饰以及巧妙精致的拼接工艺，透着品牌一贯的高街味道。与此同时，满版的墨点印花设计也值得关注，网眼布材质对于细节的雕琢更是将街头Swagger独有的律动感呈现出来。在保证街头风格之上，将剪裁、用料、细节各方面都做到极致，目前已于网络店铺开始贩售，喜欢的朋友不妨至YOHO!BUY有货进行购买！text: 粗眉
2025年04月11日
1. Swagger（俗称：丝袜哥）是什么东西？
Swagger 是一个规范和完整的框架，用于生成、描述、调用和可视化 RESTful 风格的 Web 服务。总体目标是使客户端和文件系统作为服务器以同样的速度来更新。文件的方法，参数和模型紧密集成到服务器端的代码，允许API来始终保持同步。Swagger 让部署管理和使用功能强大的API从未如此简单。
2025年04月11日
前后端接口联调需要API文档，我们经常会使用工具来生成。之前经常使用Swagger来生成，最近发现一款好用的API文档生成工具smart-doc, 它有着很多Swagger不具备的特点，推荐给大家。
2025年04月11日
最近简单的学习了一下Golang，并且用Gin开发了两个小应用，一个短域名生成，一个微信小程序。感受到了Golang的代码简洁、部署简单、内存占用少、零停机平滑重启等优势。在开发小程序的时候，需要生成接口文档，这里需要用到Gin-Swagger了，所以简单的就来整理一下。
这里我用的环境是：
2025年04月11日
当我们使用swagger，进行接口测试，怕接口不安全，担心暴露。可以采用两种方式
可以对swagger文档配置只在测试环境可访问，生产环境不可访问。
@Profile({"dev","test"})2025年04月11日
最近学习go语言，使用gin框架，在整合knife4j swagger时，发现资料非常少，整合之后也有很多不如意，所以自己整合了一个学习项目：项目地址
https://gitee.com/longyancang/knife4jgo
1.支持自定义panic拦截器
2.支持参数验证错误描述拦截
3.支持自定义响应体