Skip to content

zeta-oss/swagger2springdoc

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

15 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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