add javadoc for java client to api rest-api