Приходилось ли описывать OpenAPI спецификации?

Уточните, писали ли спецификацию OpenAPI самостоятельно, редактировали её или только использовали документацию. Приведите пример операции и частей контракта, за которые отвечали.

Полезно рассказать о методе и пути, параметрах, схемах запроса и ответа, статусах, ошибках и безопасности. Уточните, как согласовывали изменения с разработчиками и потребителями и проверяли соответствие реализации. Генерация из кода и ручное описание имеют разные риски рассинхронизации. Не называйте просмотр Swagger UI полноценным опытом проектирования спецификаций.