3 месяца назад
Как задокументировать API с помощью Swagger в Node.js
В типичном сервере на Node.js с Express есть несколько основных компонентов: Swagger берет данные из router, формируя на их основе понятное описание API. Для работы Swagger в проекте установим два пакета: npm install swagger-ui-express swagger-autogen Создадим файл в корне проекта: swagger.js const swaggerAutogen = require('swagger-autogen')(); const outputFile = './swagger_output.json'; // Файл, куда сохранится документация const endpointsFiles = ['./routes/*.js']; // Пути к файлам с маршрутами swaggerAutogen(outputFile, endpointsFiles); * Когда мы запустим этот файл (node swagger...
🚀 Вышла свежая статья от Андрея Порожнякова — «Scalar вместо Swagger UI
🚀 Вышла свежая статья от Андрея Порожнякова — «Scalar вместо Swagger UI. Надо ли оно нам?». Читаем на Habr: https://habr.com/ru/articles/892508/ Коротко о главном 🔹 В шаблоне ASP.NET Core Web API для .NET 9 Microsoft убрала Swashbuckle и по умолчанию ставит Microsoft.AspNetCore.OpenApi — Swagger UI больше не приезжает “из коробки”. 🔹 Автор показывает два пути, как вернуть Swagger UI, если без него никак: либо полностью перейти на Swashbuckle, либо оставить OpenApi для схемы, подключив только UI...