swagger2springdoc 🦾

swagger2springdoc


Why 📚

Most dev-teams are fairly comfortable performing operations on Swagger specifications such as,

  1. Stitching APIs together to create a cohesive OAS 3 Spec
  2. 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 💻

  1. Simply go to swagger2springdoc

  2. Paste a Swagger specification like the one here

  3. Copy paste Annotations for each API into your Codebase

  4. ? ? ?

  5. 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

GitHub

View Github