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
Post a Comment