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

authentication - Mongodb revoke acccess to connect test database -

ios - Realm over CoreData should I use NSFetchedResultController or a Dictionary? -

r - Update two sets of radiobuttons reactively - shiny -