Короткая суть. Некоторые команды до сих пор хранят «правду» об API в трёх несовместимых местах: в голове бэкендера, в страничке Confluence, которая устарела ещё прошлой весной, и в реальном JSON, который прилетает с прода. Эти три источника постоянно расходятся, и расплачиваются за это все — особенно клиентские разработчики. OpenAPI — это способ свести правду к одному файлу-контракту, понятному и человеку, и машине. В статье я разбираю, зачем это нужно, почему кодогенерация — далеко не главная причина, но при этом проговариваю, во что внедрение обойдётся бэкенду, и где у подхода реальные слабые места.
Рубрика «openapi»
Вики врёт, прод молчит: почему пора сделать OpenAPI единственным источником правды о вашем API
2026-06-06 в 9:46, admin, рубрики: openapi, rest, swift, кодогенерацияHttpClient в Spring 7: замена FeignClient или нет?
2026-04-12 в 10:15, admin, рубрики: feignclient, httpclient, java, openapi, restclient, spring, spring boot, webclient, микросервисыЗа последние несколько лет для вызова внешних API в каждом втором (если не первом) проекте я видел одну и ту же картину:
-
RestTemplate -
или
FeignClient
Причём Feign почти всегда шёл в связке с OpenAPI: сгенерировали клиент, получили интерфейсы и не думаем о реализации. Удобно, красиво, привычно.
Но потом в Spring появился нативный декларативный HttpClient, который работает поверх RestClient / WebClient
И у меня возник вопрос: а можно ли им заменить Feign, не потеряв удобство?
Спойлер: да, можно и будет даже удобнее.
Откуда вообще взялся HttpClient
Идея, на самом деле, очень простая.
Читать полностью »Согласованность API по принципу единого источника истины
2026-02-25 в 8:16, admin, рубрики: api, hono.js, javascript, monorepo, openapi, RPC, SSOT, TypeScript, zodПривет!
Представим ситуацию: идет тяжёлый спринт, вы выполнили кучу задач, написали тонну нового функционала, готовитесь к релизу и вдруг обнаруживайте, что часть фич перестала работать! Идёте разбираться и обнаруживайте, что оказывается бэкендер Вася в последний момент решил переименовать поля в json-е, а вам об этом не сказал!
Ситуация образная, но позволяет быстро обрисовать одну из болей во время разработки. В этой статье я бы хотел рассказать об одном из вариантов её решения в коде с помощью подхода Единого источника истины(Single source of truth).
Ритуал создания API в традициях древних ацтеков
2026-01-06 в 17:15, admin, рубрики: flask, openapi, python, swagger, web
90% кода
2025-10-06 в 9:31, admin, рубрики: claude, codex, openapi, sql, автоматизация, агенты, архитектура, ИИ код, разработкаКоманда AI for Devs подготовила перевод статьи о том, как меняется программирование с приходом ИИ. Автор делится опытом: в его проекте уже 90% кода пишется агентами, но вся ответственность за архитектуру и продакшен остаётся на нём. По мнению автора, это не далёкий прогноз — это уже реальность, просто распределённая неравномерно.
«Я думаю, что через три-шесть месяцев мы придём к тому, что ИИ будет писать 90% кода. А ещё через год — к миру, где ИИ пишет фактически весь код».
Frontend и OpenAPI: генерация клиента, мокирование API и данных с помощью MSW
2025-07-16 в 21:56, admin, рубрики: Mocks, msw, openapi, TypeScriptВ нашей компании в процессе разработки frontend‑приложений мы иногда сталкиваемся с одной из следующих ситуаций (или с обеими сразу):
-
Когда мы имеем достаточно объемную и часто меняющуюся спецификацию API. Тут нам поможет генерация кода на основе этой спецификации.
-
Когда нам нужно работать с функционалом, отвечающим за обработку обращений к различным эндпойнтам, но сами запросы не работают по каким‑либо причинам. Эту проблему можно решить подстановкой в соответствующих местах mock‑объектов.
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 и ещё дюжиной популярных стеков.
FastOpenAPI: автодокументация OpenAPI для разных фреймворков на Python
2025-04-23 в 12:30, admin, рубрики: aiohttp, falcon, flask, openapi, python, sanic, starlette, tornado, сезон open source
Optional vs Nullable на стыке технологий
2025-04-20 в 17:16, admin, рубрики: kotlin, openapi, swift, TypeScriptПри разработке современных приложений важнейшую роль играет качество клиент-серверного взаимодействия. Для достижения стабильной связи между мобильными и веб приложениями и серверной частью необходимо стремиться к созданию надежного и эффективного механизма обмена данными. Это подразумевает создание устойчивого API, которое трудно сломать даже при изменениях в архитектуре сервера, а также легкость интеграции новых клиентов.
Академия OpenAI для разработчиков: Разбор 10 лекций про API, RAG, Fine-tuning
2025-04-11 в 12:24, admin, рубрики: chatgpt, distillation, Fine-tuning, llm, OpenAI, openapi, rag, обучениеOpenAI запустила свою Академию — десятки видеолекций. Полезно, но много. Если вы разработчик или аналитик, которому нужны технические детали и практические руководства по API, моделям и их оптимизации, смотреть всё подряд — не вариант.
Я изучил доступные материалы и сделал выжим из только технических материалов. Этот гайд проведет по 10 ключевым лекциям вышедшим на сегодня, которые помогут разобраться в Function Calling, RAG, Fine-tuning, Evals и других важных темах. Мы не будем здесь касатьсяЧитать полностью »