Привет! Меня зовут Данил, я Frontend разработчик, живу в Питере, работаю в компании Unistory. Решил рассказать на Хабре, как автоматизировать один нудный процесс.
Рубрика «swagger»
Авто-генерация типизированных API контроллеров на клиенте из Swagger
2025-03-21 в 13:16, admin, рубрики: api, api-codegeneration, client-api, codegen, openapi, swagger, swagger-typescript-api, TypeScript, автоматизация, клиентСоздание 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.
Это выглядит вот так:
Кодогенерация из OpenAPI v3 (aka Swagger 3) в TypeScript и не только
2020-01-12 в 14:08, admin, рубрики: codegeneration, front-end разработка, javascript, open source, openapi, swagger, TypeScriptДва года назад я начал разработку еще одного свободного кодогенератора из OpenAPI Specification v3 в TypeScript (он доступен на Github). Изначально, я задался целью сделать эффективную генерацию примитивных и сложных типов данных в TypeScript, с учетом различных возможностей JSON Schema, таких как oneOf/anyOf/allOf и т.п. (у родного решения от Swagger с этим были некоторые проблемы). Другая идея заключалась в том, чтобы использовать схемы из спецификаций для валидации на фронте, бэке и в других частях системы.
Почему Вы должны попробовать FastAPI?
2019-12-03 в 16:45, admin, рубрики: api, asyncio, fastapi, openapi, python, rest, swagger
Лого взято из Github репозитория FastAPI
FastAPI — относительно новый веб-фреймворк, написанный на языке программирования Python для создания REST (а если сильно постараться то и GraphQL) API, основанный на новых возможностях Python 3.6+, таких как: подсказки типов (type-hints), нативная асинхронность (asyncio). Помимо всего прочего, FastAPI плотно интегрируется с OpenAPI-schema и автоматически генерирует документацию для вашего API посредством Swagger и ReDoc
FastAPI построен на базе Starlette и Pydantic.
Starlette — ASGI микро-фреймворк для написания веб-приложений.
Pydantic — библиотека для парсинга и валидации данных основанная на Python type-hints.