To document your APIs using Swagger, follow these steps: 1. **Add Swagger Dependencies**: Add the Springfox Swagger dependencies to your `pom.xml`: ```xml io.springfox springfox-swagger-ui 3.0.0 io.springfox springfox-boot-starter 3.0.0 ``` 2. **Configure Swagger**: Create a Swagger configuration class: ```java @Configuration @EnableSwagger2 public class SwaggerConfig { @Bean public Docket api() { return new Docket(DocumentationType.SWAGGER_2) .select() .apis(RequestHandlerSelectors.any()) .paths(PathSelectors.any()) .build() .apiInfo(apiInfo()); } private ApiInfo apiInfo() { return new ApiInfoBuilder() .title("E-commerce Platform API") .description("RESTful APIs for Product, Order, and Payment Services") .version("1.0") .build(); } } ``` 3. **Add Swagger Annotations**: Annotate your controllers with Swagger annotations: ```java @Api(value = "products", description = "Product Service API") @RestController @RequestMapping("/api/products") public class ProductController { @ApiOperation(value = "Get all products", notes = "Returns a list of all available products") @ApiResponses(value = { @ApiResponse(code = 200, message = "Successfully retrieved products"), @ApiResponse(code = 500, message = "Internal server error") }) @GetMapping public List getAllProducts() { // Implementation } } ``` 4. **Access Swagger UI**: After starting your Spring Boot application, access the Swagger UI at: ``` http://localhost:8080/swagger-ui.html ``` Here you can visualize and test your APIs. 5. **Test Your APIs**: Use Swagger UI to test your API endpoints by expanding each endpoint and clicking the "Try it out" button. Next Steps: - After completing the Swagger documentation, move on to testing your API endpoints using Postman or similar tools. Further Reading: - [Swagger Documentation](https://swagger.io/docs/) - [Springfox Swagger Integration](https://springfox.github.io/springfox/docs/current/) - [OpenAPI Specification](https://www.openapis.org/) Note: Consider using SpringDoc instead of Springfox for newer projects, as it's actively maintained and supports OpenAPI 3.0.