Рубрика «swagger»
Ритуал создания API в традициях древних ацтеков
2026-01-06 в 17:15, admin, рубрики: flask, openapi, python, swagger, web
Scalar на замену Swashbuckle в .NET 9 и как это готовить с Design API First
2025-04-26 в 20:15, admin, рубрики: .net 9, asp.net core, dotnet, dotnet core, open api, openapi, swagger, typespec, web api, webapiВ .Net больше нет Swashbuckle. То есть из коробки больше нет Swagger UI чтобы тестировать свеженаписанные API.
Microsoft поддерживают собственный пакет Microsoft.AspNetCore.OpenApi для генерации OpenAPI спецификации из кода (Code First подход), а для тестирования предлагают использовать .http файлы и Endpoints Explorer встроенный в Visual Studio. Postman и NSwag всё ещё с нами, не говоря о том что можно и сам Swashbuckle установить, только перспективы его поддержки весьма туманны.
Активно развивающейся альтернативой Swagger UI является Scalar, который можно удобно интегрировать с .Net и ещё дюжиной популярных стеков.
Авто-генерация типизированных API контроллеров на клиенте из Swagger
2025-03-21 в 13:16, admin, рубрики: api, api-codegeneration, client-api, codegen, openapi, swagger, swagger-typescript-api, TypeScript, автоматизация, клиент
Привет! Меня зовут Данил, я Frontend разработчик, живу в Питере, работаю в компании Unistory. Решил рассказать на Хабре, как автоматизировать один нудный процесс.
Проблематика
Создание REST API с NestJS и TypeORM
2024-12-30 в 18:29, admin, рубрики: NEST, nest.js, nestjs, Node, node.js, nodejs, postgresql, swagger, TypeScriptСодержание
-
Введение
-
Установка и настройка проекта
-
Создание модуля и сущности
-
Создание DTO и валидация
-
Создание сервиса и контроллера
-
Реализация CRUD операций
-
Тестирование API
-
Заключение
Введение
NestJS — это прогрессивный фреймворк для построения эффективных и масштабируемых серверных приложений на Node.js. Он использует современные возможности JavaScript и TypeScript, вдохновлен архитектурными паттернами Angular и поддерживает модульность, инъекцию зависимостей и другие современные подходы.
TypeORMЧитать полностью »
От документации к готовому API: Генерация кода из Swagger для FastAPI
2024-09-17 в 7:23, admin, рубрики: openapi generator, python, swaggerВ этой статье я расскажу о Swagger и о том, как сгенерировать API и Pydantic модели из Swagger-документации для FastAPI, используя инструмент OpenAPI Generator. В конце статьи вы найдете ссылки на исходный код.
Итак, давайте разбираться!
Для чего это нужно?
Swagger и полиморфные контракты в .NET 7
2023-03-07 в 13:00, admin, рубрики: .net, C#, dotnet, dotnet core, dto, json, ruvds_статьи, swagger, Блог компании RUVDS.com, документация, ооп, полиморфизм, Программирование
Не так давно состоялся релиз седьмой версии платформы .NET. Он привнёс множество изменений и интересных нововведений, по которым уже успели пробежаться в рамках новостного обзора.
В этой статье мы рассмотрим развитие сериализации платформы (System.Text.Json) вместе с возможностями, которые она открывает.Читать полностью »
Как перестать писать код для взаимодействия с бэкендом
2021-07-03 в 14:29, admin, рубрики: api, dart, flutter, open source, openapi, swagger, кодогенерацияПривет! Начну с главного - я лентяй. Я очень-очень ленивый разработчик. Мне приходится писать много кода - как для бэка, так и для фронта. И моя лень постоянно терзает меня, говоря: Ты мог бы не писать этот код, а ты пишешь... Так и живем.
Но что делать? Как можно избавиться от необходимости писать хотя бы часть кода?
Есть много подходов к решению этой проблемы. Давайте посмотрим на некоторые из них.
OpenAPI
Docs as Code. Часть 2: получаем документацию из кода
2021-01-29 в 7:34, admin, рубрики: documentation, swagger, swagger-ui, Блог компании Юла, Подготовка технической документации, Программирование, управление проектами, управление разработкой
Продолжаем рассказывать о применении на практике принципа работы с документацией как с кодом. В этот раз разберём получение спецификации Swagger напрямую из комментариев к коду API. В статье рассматривается роль технического писателя в процессе адаптации команды к использованию нового инструмента, а также приводятся конкретные инструкции по применению swagger-php в реальном проекте.
Читать полностью »
Документирование API в Java приложении с помощью Swagger и OpenAPI 3.0
2021-01-07 в 14:37, admin, рубрики: api, java, rest, spring, swagger, документированиеВеб-приложение часто содержит API для взаимодействия с ним. Документирование API позволит клиентам быстрее понять, как использовать ваши сервисы. Если API закрыт от внешнего мира, то все равно стоит уделить время спецификации — это поможет вашим новым коллегам быстрее разобраться с системой.
Создание документации вручную — утомительный процесс. Swagger поможет вам упростить эту работу.
Полный набор gRPC, RESTful JSON API, WS и Swagger из одного proto файла. От введения до нюансов и тонкостей grpc-gateway
2020-04-11 в 21:49, admin, рубрики: api, api server, Go, golang, grpc-gateway, protobuf, swagger, web-socketsВ этой статье я опишу процесс создания сервера с gRPC и RESTful JSON API одновременно и Swagger документацию к нему.
Эта статья — продолжение разбора различных способов реализаций API-сервера на Golang с автогенерацией кода и документации. Там я обещал более подробно остановиться на этом подходе.
grpc-gateway — это плагин protoc. Он читает определение сервиса gRPC и генерирует обратный прокси-сервер, который переводит RESTful JSON API в gRPC. Этот сервер создается в соответствии с пользовательскими параметрами в вашем определении gRPC.
Это выглядит вот так:
