Перед вами карта компетенций системного аналитика и сегодня мы поговорим про open API. Open API Open API это по сути спецификация для описания REST API, о котором мы говорили в предыдущей статье. Клиент работает с вашими серверами и сервисами (облачными или не очень) отправляя запросы и получая ответы в соответствии с определенным API. Чтобы разобраться с вашим API было проще, необходимо описать его в какой-то понятной всем нотации. Да и обновления такого описания желательно сделать автоматическими...

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