Como mínimo, se requiere @Api para declarar un recurso API y se requiere @ApiOperation para declarar una operación API. Sin tener esos dos combinados, no se generará ninguna salida. Los servlets requieren @ApiImplicitParam para definir los parámetros del método, mientras que la aplicación basada en JAX-RS puede utilizar las anotaciones básicas @XxxxParam ( @QueryParam , @PathParam ...).
Marca una clase como un recurso de Swagger.
# @ApiImplicitParam
Representa un solo parámetro en una operación API.
# @ApiImplicitParams
Un contenedor para permitir una lista de múltiples objetos ApiImplicitParam.
# @ApiModel
Proporciona información adicional sobre los modelos de Swagger.
# @ApiModelProperty
Agrega y manipula datos de una propiedad modelo.
# @ApiOperation
Describe una operación o típicamente un método HTTP contra una ruta específica.
# @ApiParam
Agrega metadatos adicionales para los parámetros de operación.
# @ApiResponse
Describe una posible respuesta de una operación.
# @ApiResponses
Un contenedor para permitir una lista de múltiples objetos ApiResponse.
# @Autorización
Declara un esquema de autorización para ser utilizado en un recurso o una operación.
# @AuthorizationScope
Describe un alcance de autorización de OAuth2.