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

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

7 ответов

20 просмотров

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

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

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

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

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

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

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

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

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

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

Ребята, всем привет. Подскажите, пожалуйста, можно ли как-то через бота понять, что этого бота добавили в группу\канал и выдали ему права администратора?
Artem Stormageddon
9
Это переведённый текст с английского. Я не говорю на русском, но могу использовать переводчик Телеграм. Приветствую! Я начинающий веб-разработчик и все еще учусь. В настояще...
𐩱𐩪𐩣𐩱𐩲𐩺𐩡
2
А не хотим ли мы развлечься? 😉 Но так чтобы с пользой для наших профессиональных навыков?? 👨‍🎓👩‍🎓 Предлагаю на октябрь запланировать тестовый запуск новой командной игры "Игр...
Andrii Kurdiumov
2
Привет всем! Почему этот код не срабатывает при добавлении или удалении пользователя из чата? bot.on('chat_member', async (ctx) => { console.log(ctx); }) bot.launch({allo...
Alexander
5
у кого сколько оперативы на базе данных ?
АДИЛЬБЕК
4
Через бот апи возможно получить ID стикерпака? Не ссылку.
Vexylon [АФК до 09.09]
5
Привет Хочу сделать аналог iCloud’а для своих проектов, чтобы пользовательская информация хранилась в облаке, была доступна во всех сервисах, её можно было подсасывать везде)...
Виталий
9
В тг можно спарсить всех кто пишет в группе? Если список участников скрыт
S
3
код Event::listen('cms.page.display', function (&$content, $slug, $page, $html) { if (is_object($content)) { dump($content); } else { dump($s...
Point 111
3
Доброе утро, мультиязычные сайты делал кто-нибудь? Какие подводные камни? Нужно чего нибудь допом ставить? Как поступить? В теории сделать две папки ru en и туда кидать страни...
Racoon Mitya
2
Карта сайта