Criação de documentação usando Swagger

procedimento para criação da documentação de um webservice com a utilização de swagger deve se utilizar dos seguintes critérios a classe que será documentada deve receber a anotação @api do pacote io swagger annotations api , que consiste na identificação da categoria a qual o webservice se refere, como por exemplo ticket, requisição de mudança etc dentro da anotação @api, na propriedade tags é onde se deve colocar a identificação da categoria do webservice a qual recebe um valor do enum apitagsenum o enum apitagsenum é o responsável por guardar as categorias ao qual o webservice pode pertencer cada enum é composto pelo valor do enum e uma instãncia da classe tag (pacote springfox documentation service tag ) que recebe o valor do enum e a descrição do que esse enum representa após a configuração desses cenários, para inserir a documentação do webservice de fato, deve se criar uma interface a qual o webservice relacionado deve implementar na interface é o lugar onde a documentação será escrita de fato são utilizadas mais frequentemente as seguintes anotações as demais anotações são as comumente utilizadas em um webservice criado utilizando o spring, que agora são trazidas para a interface para serem implementadas no webservice desejado para verificar se a documentação foi adicionada com sucesso, adicione webmvc/swagger ui html# após o citsmart/ na url também é possível acessar diretamente a documentação do webservice desejado basta informar na url o path do webservice que deseja ver a documentação