Use OpenAPI/Swagger version 3 instead of version 2

[jean553]

Blocked to version 2.0 for now, as it seems there is no online resource/tool to check the syntax.

[allan-simon]

note that there's currently a draft of json-schema to "validate/check" the openapi v3 format
OAI/OpenAPI-Specification#1270