[TOC] > [在线dmeo](https://petstore.swagger.io/) > [swagger 2.0 文档](https://swagger.io/docs/specification/2-0/adding-examples/) ## 概述 Swagger 是一套基于 OpenAPI 规范（OpenAPI Specification，OAS）构建的开源工具，后来成为了 Open API 标准的主要定义者 **Swagger 主要包含了以下三个部分** * Swagger Editor：基于浏览器的编辑器，我们可以使用它编写我们 OpenAPI 规范,[在线编辑](https://swagger.io/tools/swagger-editor/)。 * Swagger UI：它会将我们编写的 OpenAPI 规范呈现为交互式的 API 文档，后文我将使用浏览器来查看并且操作我们的 Rest API。 * Swagger Codegen：它可以通过为 OpenAPI（以前称为 Swagger）规范定义的任何 API 生成[服务器](https://cloud.tencent.com/product/cvm?from=10680)存根和客户端 SDK 来简化构建过程