Swagger – это инструмент и фреймворк для создания и генерации API документации. Swagger позволяет разработчикам описывать свойства, методы и запросы для своих API, а затем генерировать документацию в формате HTML, JSON или Markdown. Swagger также предоставляет возможность прокси-сервера для тестирования API на различных этапах разработки. Swagger был создан в 2011 году компанией Reverb Technologies и с того времени стал де-факто стандартом для создания API документации. В 2015 году Swagger был объединен с фреймворком OpenAPI, и сейчас они используются взаимозаменяемо...

Источник: Nuances of Programming Часть 1, Часть 2, Часть 3 В предыдущей статье мы создали RESTful API в Golang. Теперь, когда у нас есть готовый проект, надо понять, как его использовать. Ведь если нельзя протестировать проект и увидеть его возможности, он будет просто бесполезен. Без полноценной документации, позволяющей тестировать конечные точки и видеть возможности проекта, пользователи не будут даже пытаться его использовать. Стало быть, нужно написать документацию, но на это может уйти много времени, которое можно было бы потратить на разработку крутых функций для наших приложений...