swagger
-
Хабрахабр
OpenAPI станет проще: готовится версия 4.0
Сегодня OpenAPI считается стандартом де-факто для описания программных интерфейсов. Основной смысл этих спецификаций в том, что и документация, и серверный интерфейс API генерируются автоматически на основании схемы OpenAPI. Во-первых, это гарантирует актуальность документации и её соответствие реально используемым методам. Во-вторых, сильно облегчает жизнь потребителям API, у которых автоматически генерируется клиентский код. До появления расширения OpenAPI DevTools проектировать схему OpenAPI приходилось…
Читать далее » -
Хабрахабр
Новые фичи в IDEA 2023.2 EAP 7
Быстро приближается релиз IntelliJ IDEA 2023. 2, а значит, текущему EAP-у осталось жить недолго. Вы все еще можете успеть попробовать новые фичи, и попросить исправить их до релиза, когда исправлять будет уже поздно. JetBrains ушел из России, но его IDE всё ещё является основным средством разработки на Java. Как у бывшего product marketing manager в JetBrains, у меня есть некоторый…
Читать далее » -
Хабрахабр
Документирование API сервисов с помощью Swagger на примере фреймворков Express.js и Gin
В современных реалиях разработки программного обеспечения бывает достаточно трудно быстро и качественно написать техническую документацию к проекту, особенно когда данному процессу уделяется недостаточно времени по разным причинам: от временных ограничений, до индивидуальной непереносимости монотонного процесса участниками проектной группы, который, порой, может тормозить рабочие процессы. Уже сейчас существуют инструменты, которые позволяют ускорить процесс документирования программного обеспечения. Эти инструменты значительно облегчают задачи…
Читать далее » -
Хабрахабр
Swagger и полиморфные контракты в .NET 7
Не так давно состоялся релиз седьмой версии платформы .NET. Он привнёс множество изменений и интересных нововведений, по которым уже успели пробежаться в рамках новостного обзора. В этой статье мы рассмотрим развитие сериализации платформы (System. Text. Json) вместе с возможностями, которые она открывает. ▍ До релиза .NET 7 Платформа взяла плотный курс на «импортозамещение», так сказать. Множество NuGet-пакетов, ранее популярных среди…
Читать далее » -
Хабрахабр
ogen: OpenAPI v3 генератор для Go
Чем больше кода, тем больше багов. Проект ogen генерирует код по OpenAPI спецификации, избавляя от сотен (или даже тысяч) строк скучного шаблонного кода на Go, который приходится писать вручную с риском допустить опечатку или ошибку. Генератор пишет клиент и сервер, а разработчику остаётся только реализовать интерфейс для сервера. И никаких interface и рефлексии, только строгая типизация и кодогенерация. Я расскажу,…
Читать далее » -
Хабрахабр
Разрабатываем REST API с помощью TypeScript, NestJS, Prisma, AdminJS и Swagger
Привет, друзья! В данном туториале мы разработаем простой сервер на NestJS, взаимодействующий с SQLite с помощью Prisma, с административной панелью, автоматически генерируемой с помощью AdminJS, и описанием интерфейса, автоматически генерируемым с помощью Swagger. Все это будет приготовлено под соусом TypeScript. Репозиторий с кодом проекта. Если вам это интересно, прошу под кат. NestJS — это фреймворк для разработки эффективных и масштабируемых…
Читать далее » -
Хабрахабр
Проверяем защищённость приложения на Go: с чего начать
Привет! Меня зовут Александра, я инженер по информационной безопасности в Delivery Club. Мы используем Go в качестве основного языка для разработки Web-API и представляем вашему вниманию краткое руководство по быстрой проверке сервиса на соответствие базовым требованиям безопасности. Представленную ниже информацию можно адаптировать под проекты, написанные и на других языках. Код Проверка пользовательского ввода Первый и один из основных этапов анализа…
Читать далее » -
Хабрахабр
Я фронтенд разработчик, а не обезьянка
Друзья, не думал, что тема еще актуальна в 2021 г., темболее на рубеже 2022. Начало битвы за фронтенд Все началось с того, что я задал вопрос «Как передать на бекенд требования к API?» в Хабр вопросах с гипотезой (сразу прошу прощения за профессиональный жаргон): Если фронты хорошо знают REST, то это реальный профит, когда они сами могут накидать в Swagger…
Читать далее » -
Хабрахабр
Как перестать писать код для взаимодействия с бэкендом
Привет! Начну с главного - я лентяй. Я очень-очень ленивый разработчик. Мне приходится писать много кода - как для бэка, так и для фронта. И моя лень постоянно терзает меня, говоря: Ты мог бы не писать этот код, а ты пишешь... Так и живем. Но что делать? Как можно избавиться от необходимости писать хотя бы часть кода? Есть много подходов…
Читать далее » -
Хабрахабр
![Фото [Перевод] Разработка REST-серверов на Go. Часть 4: применение OpenAPI и Swagger](http://orion-int.ru/wp-content/uploads/2021/06/perevod-razrabotka-rest-serverov-na-go-chast-4-primenenie-openapi-i-swagger-780x470.png)
[Перевод] Разработка REST-серверов на Go. Часть 4: применение OpenAPI и Swagger
Перед вами четвёртый материал о разработке REST-серверов на Go. Здесь мы поговорим о том, как можно воспользоваться OpenAPI и Swagger для реализации стандартизированного подхода к описанию REST API, и о том, как генерировать Go-код на основе спецификации OpenAPI. Перевод предыдущих частей:❒ Разработка REST-серверов на Go. Часть 1: стандартная библиотека.❒ Разработка REST-серверов на Go. Часть 2: применение маршрутизатора gorilla/mux❒ Разработка REST-серверов…
Читать далее »