Hi Jan,
my experience with swagger on the DMN Cloud project was that I like it as a documentation approach, but there a quite some limitations what you can express with swagger annotation. As an alternative you can write the swagger json/yml file by hand and do not use annotations. This is more expressive but has to be maintained manually
Personally I didn’t really liked the Java code which was generated by swagger for the client. And that was only for the simple DMN Cloud API.
An approach for you could be to write a swagger file which describes the parts of the REST API which are interesting for your projects and generate a client with that file.
Cheers,
Sebastian