Интеграция Swagger в NestJS
(перенаправлено с «Настройка Swagger в NestJS»)
Перейти к навигации
Перейти к поиску
Установка необходимых зависимостей
npm install @nestjs/swagger
Настройка файла main.ts
- Импорт модулей В начало файла добавляем:
import { SwaggerModule, DocumentBuilder } from '@nestjs/swagger'
- Конфигурация спецификации Объект config определяет метаданные вашей документации. Его необходимо создать внутри функции bootstrap():
const config = new DocumentBuilder()
.setTitle('Заголовок документации')
.setDescription('Описание документации')
.setVersion('Версия документации')
.build()
- Инициализация модуля Создание функции-фабрики, которая собирает спецификацию API на основе декораторов в контроллерах.
const documentFactory = () => SwaggerModule.createDocument(app, config);
SwaggerModule.setup('docs', app, documentFactory);
Метод setup подключает интерактивную документацию по пути /docs, связывая ее с приложением NestJS и созданным документом.