Какой смысл и выгода использовать Swagger?
Вот получил я пару недель заказ на бэкенд для мобильного приложения. Само мобильное приложение будет делать команда каких-то итальянцев. Тяжело было бы мне без swagger'а наладить с ними взаимодействие, а так они просто зайдут на адрес dev-сервера и смогут получить подробное описание API и протестировать его в работе.
Еще Swagger позволяет документированное API выставлять в веб (в глобальный или в внутрикорпоративный), что упрощает работу фронтендеров.
Например, почитайте тут: Как построить REST-like API в крупном проекте
Разработка под e-commerce, Проектирование и рефакторинг, Программирование, API, Блог компании Яндекс.Деньги
1. Единообразие, унификация, стандартизация, минимизация ошибок из-за взимонепонимания - когда над проектом работает несколько человек.
2. Взаимодействие фронтендеров и бэкендеров.
3. Если над проектом работает один человек - не столь важно. Но когда проект здоровый и ты все помнить уже не можешь - помогает.