Collate several micro-services into a single swagger 2.0 spec/collection -


i developing microservices using akka-http (scala). @ moment, couldn't find direct integration of swagger akka-http. nevertheless, starting microservices swagger 2.0 specs.

now 1 of challenge show consolidated api spec consuming applications. don't want share multiple specs consumers , hence want aggregate multiple swagger specs 1 single spec (if can done on fly, great). how work swagger-ui?

i suggest using many operation references possible:

paths:   health:     $ref: "path/to/your/operation.json" 

many people build simple routers combine specs single ones, can quite powerful:

https://router/{service}/{all-operations-from-service} 

if have valid spec file, swagger-ui fine. there known issues extremely large specs loading slowly, consider bug not limitation of swagger-ui (meaning it'll fixed).


Comments

Popular posts from this blog

php - Wordpress website dashboard page or post editor content is not showing but front end data is showing properly -

javascript - Get parameter of GET request -

javascript - Twitter Bootstrap - how to add some more margin between tooltip popup and element -