OpenAPI 3.1 vs 3.0.3

[narve]

We've started using open-api 3.1 instead of 3.0.3, which is good by itself. However, SwaggerUI does not currently support 3.1 and it seems the support is far away (3.1 is old, and there is not much activity on their project site).

For now, I've changed the version back to 3.0.3 (which means we have a slightly incorrect specification) so that the Swagger UI works again. I've also added another link to a Redoc version of the specification. Redoc supports 3.1.

However, internally NODES use SwaggerUI, and I have not evaluated Redoc properly (e.g. how it handles authentication etc).

So, we should either stick with 3.0.3 (doing some minor changes to fix some incorrect lines), or switch to another tool instead of SwaggerUI.

Opinions?

[cdmNSIDE]

I would prefer to keep swagger ui since it is the tool used on our side as well.
Indeed I have also seen that version 3.1 was not supported ... but hadn't had time to look at it up to now ...
Keeping 3.0.3 is definitively the solution preferred on our side