Advertisement

Swagger-Showdoc:一款用于转化Swagger JSON文档至ShowDoc的实用小工具

  •  5星
  •     浏览量: 0
  •     大小:None
  •      文件类型:None


简介:
Swagger-Showdoc是一款便捷的小工具,专门设计用来将Swagger JSON格式的API文档转换为易于阅读和管理的ShowDoc形式,极大地提高了团队间的技术文档协作效率。 许多使用Swagger的公司面临一个问题:文档可读性不高,在某些情况下甚至只能由开发人员自己理解,无法作为开放文档使用。本项目旨在帮助这些团队利用现有的swagger.json格式文件自动生成文档,并采用showDoc软件架构展示生成的文档。 技术栈包括: - Spring Boot 2.0.3 - JDK 1.8 - swagger2markup 1.3.3 - okhttp 3.11.0 使用说明: 克隆项目并直接运行SwaggerShowDocApplication,然后访问页面。输入各种参数后点击“开始文档同步”按钮。 用户在遵循本项目的协议下可以下载、安装和使用所提供的软件;作者不对任何原因导致的使用问题负责。

全部评论 (0)

还没有任何评论哟~
客服
客服
  • Swagger-ShowdocSwagger JSONShowDoc
    优质
    Swagger-Showdoc是一款便捷的小工具,专门设计用来将Swagger JSON格式的API文档转换为易于阅读和管理的ShowDoc形式,极大地提高了团队间的技术文档协作效率。 许多使用Swagger的公司面临一个问题:文档可读性不高,在某些情况下甚至只能由开发人员自己理解,无法作为开放文档使用。本项目旨在帮助这些团队利用现有的swagger.json格式文件自动生成文档,并采用showDoc软件架构展示生成的文档。 技术栈包括: - Spring Boot 2.0.3 - JDK 1.8 - swagger2markup 1.3.3 - okhttp 3.11.0 使用说明: 克隆项目并直接运行SwaggerShowDocApplication,然后访问页面。输入各种参数后点击“开始文档同步”按钮。 用户在遵循本项目的协议下可以下载、安装和使用所提供的软件;作者不对任何原因导致的使用问题负责。
  • ShowDoc
    优质
    ShowDoc是一款在线协作的文档管理工具,适用于编写技术文档、产品需求和项目计划等,支持实时编辑与评论功能,提高团队协作效率。 在开发过程中发现了一个非常适合IT团队使用的在线API文档和技术文档工具——Showdoc。它支持编写在线API文档、技术文档、数据字典以及在线手册。
  • Auto-Swagger前端解析Swagger件并生成TS
    优质
    Auto-Swagger是一款专为前端开发者设计的工具,能够自动解析Swagger API文档,并自动生成TypeScript接口定义文件,大大提升了前后端开发效率和代码质量。 自动摇摇auto-swagger是一个命令行工具,用于爬取swagger-ui并生成请求接口文件,帮助调用者一键生成接口代码文件。 为什么需要自动摇动?在工作中,后台开发人员通常会提供一份Swagger接口文档给前端开发者使用。每当要查询某个特定的接口时,前端开发者必须从Swagger UI上获取该信息。在这过程中可能会遇到以下问题: - 调用一个不存在(404错误)或拼写有误的接口。 - 由于参数类型和名称不正确导致请求失败(返回400错误)。 - 请求方法选择不当。 这些问题往往会导致开发者在忙碌且文档数量庞大、规范性不足的情况下,容易出现错误。auto-swagger正是为了解决这些重复而繁琐的操作问题应运而生的工具。
  • Swagger 2.0 JSONPostman集合: swagger2-to-postman
    优质
    swagger2-to-postman是一款便捷实用的在线工具,能够帮助用户轻松地将Swagger API定义(JSON格式)转化为Postman Collection,极大地提升了API测试和文档编写的效率。 Swagger 2到Postman转换器 将swagger 2.0 JSON转换为Postman Collection v1的工具如下: 安装依赖项: 运行 `$ npm install` 安装所需组件。 进行NPM测试: 执行 `$ npm test` 查看转换器是否正常工作。 要自己转化文件吗? 在 `convert.js` 中提供了一个名为Swagger2Postman的jsFace类。查看 `converter.spec.js` 了解基本用法。 初始化类: ```javascript var swaggerConverter = new Swagger2Postman(); ``` (可选)设置记录器: ```javascript swaggerConverter.setLogger(console.log); ``` 转换您的Swagger 2.0 JSON: ```javascript var convertResult = swaggerConverter.convert; ```
  • 根据Swagger OpenAPI 3.0 规范,利配置 Swagger JSON 创建 API
    优质
    本工具依据Swagger OpenAPI 3.0规范,通过解析配置的Swagger JSON文件自动生成详尽的API文档,便于开发者快速理解和使用接口。 基于Swagger及其OpenAPI 3.0规范,可以通过配置Swagger JSON来生成API文档。
  • Swagger2Word:将Swagger API换为Word项目
    优质
    Swagger2Word是一款专为开发者打造的实用工具,它能够自动将Swagger定义的API文档转化为易于阅读和编辑的Word格式文件,极大提升了API文档管理和分享效率。 使用步骤(Google Chrome) 启动工程并访问swagger2Word网站后,可以采用多种方式生成word文档: - 通过输入Swagger JSON资源地址; - 上传JSON文件; - 直接输入JSON字符串。 以下是版本迭代历程的示例: --------------版本迭代历程,感谢各位小伙伴的支持-------------- **版本:SwaggerToWord 1.0 (2018-01-18)** 项目介绍:一个将Swagger API文档转换为word文档的工具。 **版本:SwaggerToWord 1.1 (2018-02-11)** 改进点: - 使用HttpClient工具类适配更多RESTful服务; - 更换官方示例文件替代旧版json 示例; - 动态生成模板,确保word文档内容完全依据 Swagger API。
  • Swagger OpenAPI 3.0规范,通过配置Swagger JSON自动生成API
    优质
    本项目遵循Swagger OpenAPI 3.0标准,利用Swagger JSON配置文件自动化生成详尽的API文档,便于开发者快速理解和使用接口。 基于Swagger规范以及Open API 3.0标准,可以通过配置Swagger JSON来自动生成API文档。
  • Swagger生成静态API
    优质
    Swagger是一款流行的API开发框架,用于设计、构建和部署RESTful风格的服务,并能自动生成静态API文档,便于开发者理解和使用。 这是一个Maven工程,可以通过Maven命令导出静态接口文档。具体的操作步骤请参见附件中的ReadMe.txt文件。
  • showdoc全套件.zip
    优质
    ShowDoc全套文件包含了项目文档管理工具ShowDoc的所有资源和资料,包括但不限于使用手册、示例文档及源代码等,旨在帮助用户高效管理和分享技术文档。 1. 先安装C环境,如果已经安装则无需再次安装。 2. 安装Wamp。 3. 将showdoc-master解压后放到:\wamp\www目录下。
  • Swagger-Typescript-API:基Swagger方案TypeScript API生成
    优质
    Swagger-Typescript-API是一款强大的基于Swagger规范自动生成TypeScript接口代码的开发工具,极大提升了前后端协同效率。 招摇打字API通过摇摇欲坠的方案生成API。支持OA 3.0、2.0,JSON,yaml格式,并且生成的api模块可以发出请求。 任何问题可以在(#招摇,打字稿-API频道)提出或询问。 您可以在相关文档中找到所有示例 它是带有模板的新版本 mustache模板适用于>4.0.0版本 用法: Usage: sta [options] Usage: swagger-typescript-api [options] 选项: -v, --version 输出当前版本号 -p, --path <路径或url到swagger方案> -o, --output <输出typescript api文件的路径>(默认为当前目录) -n, --name <输出类型名称>