标签： Swagger

Go 项目自动生成 Swagger API 文档教程

## Swagger 文档基本介绍

Swagger 2.0 和 OpenAPI 3.0 都是用于描述 **[RESTful API](https://apifox.com/apiskills/rest-api/)** 的规范。它们的主要目的是使不同的开发者和团队能够轻松地了解和使用 API，同时提高 API 的可维护性和互操作性。

Swagger 2.0 是早期版本的规范，它定义了一组基于 JSON 或 YAML 的规则，以描述 API 的各种方面，如端点、操作、参数、响应等。Swagger[……]

1：认识Swagger

Swagger 是一个规范和完整的框架，用于生成、描述、调用和可视化 RESTful 风格的Web服务。总体目标是使客户端和文件系统作为服务器以同样的速度来更新。文件的方法，参数和模型紧密集成到服务器端的代码，允许API来始终保持同步。

作用：
1.接口的文档在线自动生成。
2.功能测试。
Swagger是一组开源项目，其中主要要项目如下：

1.Swagger-tools:提供各种与Swagger进行集成和交互的工具。例如模式检验、Swagger1.[……]