jakehschwartz/finatra-swagger

Any plan to support OpenAPI spec 3.0?

xcv58 opened this issue ยท 3 comments

xcv58 commented

We are using swagger-core 1.x (support only OpenAP spec 2.0) now and there are a bunch of useful features. For example, multiple hosts support:

Can I specify multiple hosts, e.g. development, test and production?

Multiple hosts are supported in OpenAPI 3.0. 2.0 supports only one host per API specification (or two if you count HTTP and HTTPS as different hosts). A possible way to target multiple hosts is to omit the host and schema from your specification and serve it from each host. In this case, each copy of the specification will target the corresponding host.

https://swagger.io/docs/specification/2-0/api-host-and-base-path/

The known blockers:

Hate to be the +1 but... ๐Ÿ‘

maybe it's possible to make use of https://github.com/swagger-akka-http/swagger-scala-module instead?

Yeah good thinking. I gave it a try tonight but get the swagger-core library upgraded. Will give it another try during the weekend if I get a chance. Or will accept PRs :)

@xcv58 @mgd43b Gave it a shot but having issues #70