Switch to OpenAPI3 from Swagger2, to use proper Bearer token
Fixes #427 (closed):
It almost works, but I need to fix some issues with accumulating the declarations in the OpenApi monad.
Eventually we can remove the compat-shim, rewrite the ToSchema in a mechanical way and get rid of the dependencies on swagger2.