Postman导出JSON文件轻松转换为HTML或Markdown
2024-11-10Postman想必大家都不陌生,在软件开发和API测试的过程中,Postman已经成为了一个不可或缺的工具。它不仅可以帮助我们设计、发送、测试和调试HTTP请求,还可以轻松地导出接口数据为JSON格式。然而,有时候为了更直观地向团队成员展示接口信息,即文档化,我们可能需要将这些JSON数据转换为更易于阅读的格式,如HTML或Markdown。你们可能会问了,不是有专门的接口文档管理工具吗,像swagger之类的,咋不用呢?底层小测试用什么swagger,哪个方便用哪个。_postman导出json
Pont 自动生成TypeScript接口代码,自动生成类型与后端对齐
2024-05-13可参考https://github.com/alibaba/pont/blob/master/docs/customizedPont.md Pont是可以可以作为后端和前端一个良好定义接口规范的工具。相对于市面上其他的工具,他优势在于使用方便,可以配置模板自动化生成接口代码。目前我自己实践的是,在项目搭建初期,假如后端可以通过swagger配合,直接就可以将整个生成的代码目录通过config.json配置到src的目录下,后端假如更新了接口的内容,一键生成同步即可。_pont-engine
使用插件将swagger文档转html或pdf
2024-05-07github上有maven开源插件swagger2markup将swagger文档转为.adoc格式的文档,另外一个maven开源插件asciidoctorj-pdf则可以将.adoc格式的文档转为html和pdf。由于GitHub访问不稳定,在gitee上有镜像项目。所以我就贴gitee上的项目地址了。实现从swagger文档转为html或pdf的项目有两个。一个一个说。_swagger 转pdf
前端自动生成接口ts代码
2024-04-23umijs : https://www.npmjs.com/package/@umijs/openapi拿到后端swagger文档的地址在 package.json 的 script 中添加 api: “openapi”: “ts-node openapi.config.ts”,生成api执行之后会生成包含了后端所有接口的请求、实体类类型的ts文件不过因为他是基于umi框架的,使用的是他们封装的axios,我们需要手动修改成自己封装的axio_@umijs/openapi
读取swagger接口文档、自动生成前端ts或js代码
2024-04-20平时在和后端对接时,总是要把后端swagger声明好的类型在ts中再实现一遍,写一堆interface;今天推荐一个库,可以根据swagger文档,直接生成typescript 或 javascript代码,并且有良好的代码提示。由于也自动生成了相应的declare文件,所以就算是js也会有很好的代码提示。_swagger-to-ts
【JAVA swagger】解决No mapping for GET /swagger-ui.html报错
2024-03-24解决java springboot框架中No mapping for GET /swagger-ui.html报错问题_no mapping for get /swagger-ui/index.html
快速查找swagger接口的插件
2024-03-06快速查找swagger接口的插件_通过搜索引擎查找公司swagger资产