Введение Друзья, всем привет!  Меня зовут Алексей и вот уже некоторое время я занимаюсь frontend-разработкой. В этой статье я опишу один из способов реализации приложения, предоставляющего...

На данный момент я активно пользуюсь приложением Google Keep для управления заметками на смартфоне. В частности, в дополнение к приложению есть виджет для рабочего стола, который отображает активные...

Чем больше кода, тем больше багов. Проект ogen генерирует код по OpenAPI спецификации, избавляя от сотен (или даже тысяч) строк скучного шаблонного кода на Go, который приходится писать вручную с...

Не так давно состоялся релиз седьмой версии платформы .NET. Он привнёс множество изменений и интересных нововведений, по которым уже успели пробежаться в рамках новостного обзора. В этой статье мы...

Так уж вышло, что в течение своей деятельности мне немало доводилось работать с публичными API, причем как в со стороны, которая их предоставляет, так и со стороны, которая...

Кто из нас не был одурманен сказками про свагер? Мол, добавь эту волшебную штуку — да заживешь! Но плата за магию — зеленое болото нотаций. А нельзя ли обойтись только типизацией самого php?...

Для кого эта статья В основном для аналитиков, которые впервые сталкиваются с необходимостью описания запросов в Swagger, но может быть полезна всем, кто хочет разобраться или ищет подсказку как...

Хочу рассказать, как мы реализуем на практике контакты по спецификации OpenAPI, стараемся следовать подходу Contract First и в целом разрабатывать так, чтобы удобно было...

Возможно кому-нибудь понадобится этот хак, ибо я не смог найти подходящее моей проблеме решение в официальной документации Swagger. Суть проблемы Минимальное описание Swagger, а именно поле example,...

Если вы работаете с API, вы наверняка сталкивались с OpenAPI или Swagger для описания ваших API-спецификаций. Хотя эти инструменты облегчают процесс документирования, порой работать с ними через...

Это перевод статьи от Philipp Acsany Большинство современных веб-приложений работают на основе REST API - методологии, позволяющей разработчикам отделить разработку пользовательского интерфейса...

TL;DR Подробная документация на сайте typespec.io . Инструмент позволяет упростить процесс документирования API за счёт использования нового языка TypeSpec (файлы с расширением *.tsp) и плагина для VS...

Это перевод статьи от Philipp Acsany Большинство современных веб-приложений работают на основе REST API - методологии, позволяющей разработчикам отделить разработку пользовательского интерфейса...

Привет, Хабр! Понимаете ли вы пользу документации? Конечно да. Наверняка каждый встречался с ужасно или вовсе не задокументированным проектом. Это всегда больно и с языка так и срываются матерные...

Содержание Введение Установка и настройка проекта Создание модуля и сущности Создание DTO и валидация Создание сервиса и контроллера Реализация CRUD операций Тестирование API Заключение Введение...