Skip to content

feature/api-documentation- Add OpenAPI (Swagger) UI for API Documentation in Spring Boot Application #62

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: main
Choose a base branch
from

Conversation

Mohammad-Husen-Mulla
Copy link

Description:

This pull request integrates OpenAPI (formerly Swagger) UI into our Spring Boot application to enhance API documentation.

Changes Included:

  1. Added OpenAPI Dependencies: Included dependencies for OpenAPI (Swagger) in the pom.xml.
  2. Configured OpenAPI: Spring Boot auto-configures OpenAPI, so no additional configuration is required for basic usage.
  3. Updated Project Files: Added the necessary dependency configurations, Annotations inside the main application class and inside all the controllers

Benefits:

  • Enhanced API Documentation: Provides a modern and interactive web interface for developers to explore and test API endpoints.
  • Improved Usability: Offers an easy-to-navigate and user-friendly interface for understanding and interacting with the API.

Screenshot:

Spring-boot-rest-swagger-ui

How to Test:

1. Run the Application:

  • Start the Spring Boot application using mvn spring-boot:run.

2. Access OpenAPI UI

3.Verify Documentation:

  • Ensure that the OpenAPI UI displays all available API endpoints.
  • Test the interactive features to verify that the endpoints are functional and correctly documented.

Note:

Feel free to adjust the port number and version of dependencies as per your project's specifics. Let me know if there’s anything else you need!

Developer Request:

As a junior developer, I'm still in the learning phase with these technologies.
If you notice any mistakes or areas for improvement in the codebase I've worked on, please let me know. I appreciate any feedback and suggestions for further improvement. Thank you for your understanding and support! 👍🚀

Copy link

@github-actions github-actions bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks so much @Mohammad-Husen-Mulla for creating your first PR, the Spring-Boot-Blog-REST-API community thanks you :)

Copy link

@mo-shahab mo-shahab left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lgtm!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants