...
Solo debe haber un OpenApiDefinition por aplicación.
Se puede establecer como anotación del RestController si solo se tiene tenemos una clase, pero si tenemos varias clases, la notación OpenApiDefinition debe establecerse en la clase Application de nuestro proyecto (la que está anotada con @SpringBootApplication).
El título y la descripción deben ser relativos a la aplicación completa.
Ejemplo:
| Bloque de código | ||||
|---|---|---|---|---|
| ||||
@OpenAPIDefinition( info = @Info( title = "Servicios RRHH",
version = "${server.image:1.0}",
description = "API REST de Recursos Humanos" ),
servers = {
@Server( url = "${springdoc.server.url}" )
} )
@SecurityScheme( name = "OIDC",
type = SecuritySchemeType.OPENIDCONNECT,
openIdConnectUrl = "${springdoc.security.issuer-uri}/.well-known/openid-configuration" )
@SpringBootApplication( scanBasePackages = {
"es.um.atica.serviciosrrhhapi", "es.um.atica.fundewebjs"
} )
public class ServiciosrrhhApiApplication { |
- En los métodos privados, me documenta el JWT o la cabecera Authorization y no puedo probar el endpoint desde la documentación.
...