REST API уже много лет находится в разработке. Это не задокументировано и не может быть изменено.
Чтобы провести на нем тяжелое тестирование, было бы удобно найти способ сгенерировать классы клиентских заглушек с помощью OpenAPI, который поможет писать эти тесты и выполнять их вызов.
Но для этого OpenAPI необходимо какое-то описание yaml целевых служб REST. Чтобы написать это от руки, потребуются годы: сейчас уже слишком поздно.
Существует ли способ с помощью самого инструмента OpenAPI или другого средства выполнить вызов REST, который, как мы знаем, работает, и заставить инструмент вывести примитивы и структуры входных и выходных параметров из HTTP-обмена? Хотя бы для создания необходимого файла yaml?
Вот это: github.com/ePages-de/restdocs-api-spec, но он начинается с тестов Spring MockMVC, поэтому он бесполезен, когда он вам нужен перед началом написания тестов. И, я думаю, он также не генерирует json-схему.




Есть несколько инструментов, которые вы можете использовать для перехвата и записи вызовов REST, например: Fiddler2, SoapUI или Postman. Но они не будут генерировать OpenAPI.yaml. Должна быть возможность по крайней мере сгенерировать конечные точки и примеры вызовов, но невозможно сгенерировать JSON-схему исключительно из существующего ввода / вывода.