Amigos, tenho um servidor Rest para ser consumido, sei que ele está no Tomcat ou seja grande chance de ser Java, minha duvida é, existe alguma forma de eu descobrir quais as chamadas que poderei realizar neste servidor? Pergunto isso pois no Webservice é possível através do wsdl mas como fazer isso no Rest? Tem como?
uma documentação contendo o conjunto de recursos e respostas http plausivel alem dos verbos ( por exemplo, vc pode HTTP OPTIONS pra descrever os possiveis verbos http://zacstewart.com/2012/04/14/http-options-method.html ), assim como falar de autenticação, limites, etc.
opcionalmente a API REST usar hypermedia pra descrever o seu conteudo. eu nunca vi isso agregar muito valor ( honestamente falando ) porem espere outras pessoas comentarem sobre isso.
opcionalmente uma Referencia de Implementação da API em alguma linguagem que faça sentido ( como Java ). isso ajuda muito em algumas situações.
existem soluções onde vc gera a documentação dos recursos e ainda gera exemplos pra serem consumidos numa pagina web. esqueci o nome disso.