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

Этот сервис очень удобен для проектирования API. Начать им пользоваться очень просто – достаточно перейти по ссылке Try Swagger Editor. По умолчанию предлагают ознакомиться с демо проектом Swagger Petstore. Перед глазами откроется пример отлично спроектированного и документированного API, который тут же можно “потрогать” руками. Проекты сохраняются в формате YAML. При необходимости этот формат можно конвертировать в формат Json...