Господа, как версионируете апи в сваггер? Я генерирую json для него

и отдаю swagger ui
если какой то метод ломает обратную совместимость и уходит в версию v2, например
вывод версии в свагере - это понятно, всегда показывать последнюю версию api, а остальные доступны по v1
а в коде у вас это как выглядит, копируете целиком v1 в v2, а потом меняете какой то отдельный метод?

7 ответов

23 просмотра

часто тебе надо ломать совместимость?

Anton- Автор вопроса
Sergey P
часто тебе надо ломать совместимость?

смотрю на наш другой проект, но там апи не публичное, да, пару раз ломалось

Почему бы не создать новый метод, зачем всей апи инкрементить версию, если глобального ничего не случилось?

Константин Грачев
Почему бы не создать новый метод, зачем всей апи и...

т.е инкремент мажорной версии апи это глобально ничего не случилось ?

Константин Грачев
чё?

то что у человека инкремент мажорной версии апи, у него глобально случилось все что могло случиться. новая мажорная версия легко ломает обратную совместимость, но не обязательно

Похожие вопросы

Обсуждают сегодня

Добрый вечер, Пока не совсем понимаю как наладить общение между телеграм ботом и ПО для работы с сим боксом. По самому боту так понял: - Нужен некий баланс, который можно поп...
Magic
6
сделал сайт, прикрутил в боте сайт, и виджет логина. как автоматически логинить пользователя в аккаунт(телеграм), при входе с бота?
Александра Чернивецкая
5
Объясните, пожалуйста, почему компилятор ругается на использование в условии неинициализированной переменной: int x; Task.Run(async () => { x = await somefunc(); }).Wait...
Александр
5
Ребят, подскажите, пожалуйста, почему в префиксе к ассетам, которые генерируются через фильтр | theme в шаблоне, стал вдруг появляться index.php? Вот так выглядит ссылка на а...
Виталий
1
Всем привет. Ребята, подскажите, пожалуйста. у ботов есть ограничение на отправку сообщений - 30 сообщений в секунду, эти ограничения накладываются на все сообщения? или на со...
Artem Stormageddon
4
Блин, ребята, сори за тупые вопросы. А можно ли как-то открыть вебапку по нажатию на кнопку в меню(которое появляется слева, команды)?
Artem Stormageddon
3
а плаксы из-под питона умеют только в комфортных условиях что-то выдавить из себя?)
Lencore
9
Но, может, есть уже проверенная? Наши требования такие: 1. Сообщения должны приходить из Инста в CRM оду 2. Должна быть возможность подключить несколько экаунтов Инстаграм. Р...
Alexander Sharoiko MSE / Александр Шаройко
13
Это может быть все-таки не флудвейт? у меня ботфазер принимает изменения и отображает даже что они изменились, на видео видно что он прислал якобы уже измененное описание, н...
OVERLINK
13
Коллеги, может знает кто, можно ли цвет бейджа счётчика в BackendMenu менять без бубнов?
Alex Blaze
3
Карта сайта