swagger地址是什么（swagger测试地址）



简介

Swagger 是最流行的 API 开发工具，它遵循 OpenAPI Specification（OpenAPI 规范，也简称 OAS）。 Swagger 可以贯穿于整个 API 生态，如 API 的设计、编写 API 文档、测试和部署。 Swagger 是一种通用的，和编程语言无关的 API 描述规范。

Swagger Specification（Swagger 规范），规定了如何对 API 的信息进行正确描述。 Swagger 规范，以前称作 Swagger Specification，现在称作 OpenAPI Specification（简称 OAS）。 Swagger 规范本身是与编程语言无关的，它支持两种语法风格：

这两种语法风格可以相互转换，都可以用来对我们的 RESTful API 接口的信息进行准确描述，便于人类和机器阅读。 在 Swagger 中，用于描述 API 信息的文档被称作 Swagger 文档。Swagger 的规范主要有两种：

关于 Swagger 规范的详细信息，请参考官方文档

Swagger 文档（文件），指的是符合 Swagger 规范的文件，用于对 API 的信息进行完整地描述。 Swagger 文档是整个 Swagger 生态的核心。 Swagger 文档的类型有两种：yaml 文件和 json 文件。 yaml 文件用的是 YAML 语法风格；json 文件用的是 JSON 语法风格。这两种文件都可以用来描述 API 的信息，且可以相互转换。 简单的说，Swagger 文档就是 API 文档，只不过 Swagger 文档是用特定的语法来编写的。Swagger 文档本身看起来并不美观，这时，就需要一个好的 UI 工具将其渲染一番，这个工具就是 Swagger-ui。 我们可以用任何编辑器来编写 Swagger 文档，但为了方便在编辑的同时，检测 Swagger 文档是否符合规范，就有了 Swagger-editor 编辑器。

在这里插入图片描述

Swagger提供了多种工具，帮助解决api的不同的情况下的问题

Swagger-editor

【功能】

【安装】

本文使用docker部署，下载swagger-editor的容器

在浏览中输入：localhost:81，就可以在容器中编辑api文档

【使用说明】：

Swagger-editor 分为菜单栏和主体界面两个部分。 主体界面分为左右两栏，左侧是编辑区，右侧是显示区。

Swagger-editor 的菜单栏包含以下几个菜单：

选择菜单栏【File】Save as YAML，保存为swagger.yaml文件，就是我们所说的swagger文档。

文档编辑参考swagger从入门到精通

Swagger-ui

Swagger-ui 是一套 HTML/CSS/JS 框架，用于渲染 Swagger 文档，以便提供美观的 API 文档界面。也就是说，Swagger-ui 是一个 UI 渲染工具。 【安装】 docker部署，下载swagger-ui的容器

【基于swagger-ui的接口测试】

1. 选择接口点击【try it out】

2. 修改“Example Value Model”里面参数，点击“Execute”发送请求

3. 点击发送后会出现下面视图，不管发送成功／失败。你可以通过下面视图来查看请求数据：

【springboot集成swagger-ui自动生成API文档】

1、添加依赖

2、编写配置文件 在application同级目录新建swagger2文件，添加swagger2配置类

注解说明

其中 @ApiResponse参数：

原理就是在系统加载的时候，Swagger配置类去扫描所有添加注释的接口，并且储存起来通过下面地址进行访问，返回JSON数据，在前端界面显示出来。 启动项目后，访问http://localhost:8099/swagger-ui.html，显示如下：

Swagger-Codegen

Swagger Codegen是一个开源的代码生成器，根据Swagger定义的RESTful API可以自动建立服务端和客户端的连接。Swagger Codegen的源码可以在Github上找到。 GitHub:https://github.com/swagger-api/swagger-codegen 【安装】 首先机器上需要有jdk，然后只要下载一个cli的文件就可以了

【使用】 利用swagger-codegen根据服务生成客户端代码

在上面这段代码里，使用了三个参数，分别是-i和-l和-o。

除了可以指定上面三个参数，还有一些常用的：

版权声明：

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如若内容造成侵权、违法违规、事实不符，请将相关资料发送至xkadmin@xkablog.com进行投诉反馈，一经查实，立即处理！

转载请注明出处，原文链接：https://www.xkablog.com/te-aq/43672.html