OpenAPI/Swagger для начинающих

[yunus_mil]

Классная статья, сам неоднократно пользовался сваггер и по опыту знаю насколько удобно это для разработчиков и аналитиков. Спасибо автору, освежил знания )

[cherkalexander]

Как указано в статье, OpenAPI схема позволяет генерировать клиентский код. Это может быть полезно, когда сервис есть, а библиотеки у него нет. Я так например генерировал клиента для Яндекс Музыки. Описал их Open API схему и сгенерировал JS библиотеку. https://github.com/acherkashin/yandex-music-open-api/blob/main/src/yandex-music.yaml

Ну и можно генерировать аналогично библиотеку, чтобы ходить на свой бэк. Генерируешь схему для методов бэка, а из схемы клиентский код на любом языке.

[Ratenti]

Как вы Open API схему описали?