Идея HATEOAS на самом деле очень проста, то есть в ответ на ссылку, содержащую другие ресурсы, которые клиент может использовать для взаимодействия с сервером, клиент не может знать, что рабочий процесс сервера, но может знать следующие шаги в ссылка на ресурс из корневых ссылок, но только ссылка, а не параметры и примеры запросов. Это далеко от онлайновой документации, созданной Swagger2 (личные ощущения)
С другой стороны, когда речь идет о написании кода, взгляд на Spring Hateoas или использование Spring ApplicationListener жестко запрограммирован, он выглядит очень громоздким и кажется, что нет никаких аннотаций swagger2, которые легко использовать.
Эта проблема беспокоит меня, я не знаю, должен ли мой API использовать способ Hatepas