How about OpenAPI descriptions and Swagger UI in your Java REST API? | Trying things
OpenAPI/Swagger, Apache CXF™, JAX-RS Jersey, Jackson, Log4j based eclipse IDE with DSL Maven Project to Act as the base for Developing and Testing Java Clients that invoke MDM 9.1.0 RESTful Web Services