swagger2springdoc 🦾
Why 📚
Most dev-teams are fairly comfortable performing operations on Swagger specifications such as,
- Stitching APIs together to create a cohesive OAS 3 Spec
- Changing request/responses on APIs
However there comes a point when you have too many microservices that it makes sense to programatically extract swaggers from your services for use in various frontend swagger visualization tools like Redoc
This tool helps create Annotations for Springdoc
How 💻
-
Simply go to swagger2springdoc
-
Paste a Swagger specification like the one here
-
Copy paste Annotations for each API into your Codebase
-
? ? ?
-
Profit!
How can I Contribute 🚀
👍🎉 First off, thanks for taking the time to contribute! 🎉👍
Reporting Bugs / Issues / Enhancements
Please share a Swagger specification, with the path
and the method
that is breaking the happy path