При разработке ПО хорошей практикой является описание некоторого контракта, на который будут опираться все компоненты системы при взаимодействии друг с другом.

Для SOAP у вас есть WSDL, а вот для REST-сервисов такого однозначного способа описания контрактов изначально нет. Какое-то время я для этого использовал связку из Spring RestDocs и Spring Cloud Contract, но со временем и возросшей популярностью Swagger переключился на описание REST-сервисов в формате OpenAPI.

В этом ролике я постараюсь наглядно продемонстрировать способ валидации REST-сервисов на Spring при помощи Swagger во время выполнения интеграционных тестов.

Репозиторий проекта: https://github.com/alex-kosarev/sandbox-spring-openapi

Мой сайт: https://alexkosarev.name/

Паблик в VK: https://vk.com/public218833461

Канал в Telegram: https://t.me/+TZCuO38vG3oqu_Jq

Стать доном: https://vk.com/donut/shurik.codes

Донаты в Boosty: https://boosty.to/akosarev/purchase/1451735

Донаты в Tinkoff: https://www.tinkoff.ru/cf/4PEOiVCZQuS