Support for OAI v3

[yetithefoot]

Please ad support for OpenAPI v3.

[amazing-gao]

Thanks for issue. Which features in V3 you need to use?

[yetithefoot]

I just started to writing new simple api file version 3 and tried to user run router, but got syntax error. Not sure what exact feature lead to that.

{
  "name": "SyntaxError",
  "message": "./api.yml is not a valid Swagger API definition",
  "stack": "SyntaxError: ./api.yml is not a valid Swagger API definition
    at ~/api/node_modules/swagger-parser/lib/index.js:75:19
    at <anonymous>"
}

[amazing-gao]

V3 is not yet supported I use swagger-parser as the specification's parser and validator, and it's still under beta-testing. Later i will begin to v3's support work.

[kevingilbert100]

https://www.npmjs.com/package/@overspeed/koa2-oas3

This is a work in progress - but if anyone needs an example of how to do this in Node.js.

[SkeLLLa]

I'm also looking forward for 3.0 support. Mainly because they added oneOf support.

[ronkorving]

@BiteBit swagger-parser is no longer in beta, it seems. Their master branch is very uptodate. Any plans on upgrading?

[amazing-gao]

@BiteBit swagger-parser is no longer in beta, it seems. Their master branch is very uptodate. Any plans on upgrading?

I will try to upgrade recently.

[jsdevel]

Check out https://github.com/kogosoftwarellc/open-api/tree/master/packages/koa-openapi. V3 is supported, and it's also possible to add oneOf to V2 as an extension.

[amazing-gao]

Check out https://github.com/kogosoftwarellc/open-api/tree/master/packages/koa-openapi. V3 is supported, and it's also possible to add oneOf to V2 as an extension.

It looks good, maybe a good choice.