Configuración de Swagger

Swagger permite documentar las APIS de un proyecto de forma automática.

Para usar swagger en un proyecto maven, se debe seguir los siguientes pasos

• Configuración de dependencias en proyecto maven.

   <!--SWAGGER-->
<dependency>
	<groupid>io.springfox</groupid>
	<artifactid>springfox-swagger2</artifactid>
	<version>2.9.2</version>
</dependency>

<dependency>
	<groupid>io.springfox</groupid>
	<artifactid>springfox-swagger-ui</artifactid>
	<version>2.9.2</version>
</dependency>

• Crear una clase SwaggerConfig configurada con las anotaciones: @Configuration
  @EnableSwagger2 y que retorne un objecto de tipo Docket

@Configuration
@EnableSwagger2
public class SwaggerConfig {
	
	@Bean
	public Docket apiDocket() {
		return new Docket(DocumentationType.SWAGGER_2)
				.apiInfo(getApiInfo())
				.select()
				.apis(RequestHandlerSelectors.any())
				.paths(PathSelectors.any())
				.build();
		
	}

	private ApiInfo getApiInfo() {
		return new ApiInfoBuilder().title("WARRIOR-SOFT")
				.description("REST WebServices HOME-PAY")
				.contact(new Contact("WARRIOR-SOFT", "www.warrior-soft.com", "info@warriorsoft.com"))
				.version("1.0")
				.build();
				
	}

}

• Ingresar a la consola de swagger

•  http://localhost:8080/swagger-ui.html

Fuentes:

https://www.oscarblancarteblog.com/2020/08/28/documentar-un-api-rest-con-swagger-y-spring-boot/