OpenAPI — это спецификация, описывающая API-интерфейсы RESTful в форматах JSON и YAML так, что он понятен и людям, и машинам.Определения OpenAPI не привязаны к конкретному языку и могут...

Друзья, не думал, что тема еще актуальна в 2021 г., темболее на рубеже 2022.Начало битвы за фронтендВсе началось с того, что я задал вопрос «Как передать на бекенд требования к API?» в Хабр вопросах с...

Привет! Я Алексей, Java-разработчик. Хочу поделиться опытом внедрения подхода Contract-First в backend. Что такое контрактПредставим продакшн и три группы участников: мобильное приложение, бэкенд...

О том, как найти баги в любом API за 5 минут и чем поможет Swagger Spec First + Schemathesis там, где генерация API контрактов из кода не предусмотрена или невозможна.Swagger – это?Многие разработчики...

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

В этой статье я — Станислав Решетнев, Teamlead команды разработки Link Building в компании Sape — хочу рассказать об опыте нашей компании по избавлению от legacy. Многие компании сталкиваются с...

Вступление Статья представляет собой сборник ссылок и рецептов, позволяющих настроить API более гибко, более удобно для frontend разработки. Основная часть статьи будет посвящена интеграции OpenAPI в...

Недавно я прочитал книгу « README. Суровые реалии разработчиков » Криса Риккомини и Дмитрия Рябого. Я сам в чем-то похож на новичка, поэтому решил попробовать. Эта книга полна хороших советов для...

Разрабатываемые приложения со временем имеют свойство увеличиваться и обрастать новым функционалом. Как правило, сетевой слой при этом также разрастается, порой до немыслимых размеров. Поддерживать...

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

API First - это принцип разработки, по которому API вашего приложения является наиболее важной частью вашего приложения. Этот принцип применяется как для клиентской разработки, так и для серверной....

Здесь я рассказывал о том, как настроить генерацию в приложении. В этой статье покажу несколько пример сгенерированного года с использованием композиции и полиморфизма openapi. Здесь можно почитать...

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

Всем привет! Я Ира — тимлид команды, которая занимается развитием и поддержкой публичного API hh.ru . Несколько лет назад к нам пришли ребята из мобильной команды и сказали, что хотят документацию в...

Сегодня OpenAPI считается стандартом де-факто для описания программных интерфейсов. Основной смысл этих спецификаций в том, что и документация, и серверный интерфейс API генерируются автоматически на...

Привет, меня зовут Роман Брылунов, я QA Automation в команде сервиса транспорта 2ГИС. Мы автоматизируем сервисы транспортных сценариев, таких как построение маршрутов для разных видов транспорта,...

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

Данный текст преимущественно ориентирован на начинающих системных аналитиков, а также всех, кто интересуется проектированием IT-систем. Постановка задачи Представим, что есть компания, продающая...

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

Привет, Хабр! Пол года назад на AnalystDays #18 я рассказывал про API-контракты, и доклад вызвал большой интерес у аудитории. Вот видео , ниже материал в формат статьи. На конференции я начал...