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

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

7 ответов

22 просмотра

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

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

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

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

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

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

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

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

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

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

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