Imagem de fundo

Uma analista estã trabalhando em uma API Spring Boot e...

Uma analista estã trabalhando em uma API Spring Boot e precisa documentar os endpoints utilizando anotações do Swagger para descrever operações, parâmetros e respostas. Ela quer garantir que a documentação seja clara e compativel com a especificação OpenAP| 3.0, mas estã incerta sobre qual conjunto de anotações usar e como aplicá-las corretamente em um controlador. O endpoint em questão é um GET /processos/{id} que retoma os detalhes de um processo. Nesse cenário, a maneira correta de anotar o endpoint GET /processos/{id} em um controlador Spring Boot para garantir uma documentação precisa e compativel com OpenAP! 3.0, usando a biblioteca springdsc-openapi, É usar


A

@Apilperation é

@ApiFaram do pacote io. swagger.annotations para descrever a operação é à parâmetro.


B

@Apilperation do pacote io.swagger.annotations combinado com @Operation do pacote io.swagger.v3.oas.annotations.


C

apenas @GetMapping sem anotações do Swagger, pois springdoc-openapi gera documentação automaticamente.


D

@Schema no método do controlador para descrever o parâmetro {id}.


E

@Operation e @Parameter do pacote io.swagger.v3.oas.annotations para descrever a operação e o parâmetro.