OpenAPI 3.1 support issues

[RomanHotsiy]

We've released support for openapi 3.1 in the RC.54

This is an umbrella issue to track the issues about it.

Known issues

• if/then/else keywords from openapi 3.1 are not supported, feat: support conditional operators #1939
• Wrong name of object is shown when using $ref in OAS 3.1 #1643
• $ref using $id support
• $ref siblings missing in schemas OpenAPI 3.1: Missing description when $ref used #1727
• OpenAPI 3.1: Missing description when $ref used #1727
• merge allOf while bundling redocly-cli#629
• TBD

[adamaltman]

#1727

[zalesky]

#1761
#1788

[m-mohr]

It would be great if the README could elaborate on what "basic" OpenAPI 3.1 support means. What is it lacking in comparison to the premium variant? It would help understand the limitations better.

[adamaltman]

@m-mohr the known issues are posted above. Did you find something else? If so, please report the issue and also the link into this tracking issue. Thank you.

[m-mohr]

@adamaltman No, I have no specific issues, but the README implies that there are limitations in the Redoc community edition:

The "(basic)" implies that there are limitations or so to Redoc CE. I'm wondering what the differences are. If there are no differences, I guess the "(basic)" should be removed? Otherwise, it would be nice to document what is missing so that people can understand what is missing and whether it's worth upgrading/switching/PRing or so.

[jehanzebqayyum]

Does propertyName in map works in redoc?

[crossan007]

It looks like OpenAPI 3.1 added support for scopes in authentication schemes other than oauth (OAI/OpenAPI-Specification#1366)

Using both 0.13.10 as well as the live demo (https://redocly.github.io/redoc/), the rendered HTML file does not seem to include scopes for API Key authentication methods in the list of authentication methods.

Strings included in the individual "route" level security array are rendered in the HTML output.

[adamaltman]

Support for unevaluatedProperties.

#1955

[AlexVarchuk]

#1983

[AlexVarchuk]

Add support prefixItems and uniqueItems to JSON Schema

[AlexVarchuk]

#2142

[AlexVarchuk]

#2364

[jeremyfiel]

Redocly/redocly-cli#1233 (comment)

[bartfeenstra]

I've just run into the $ref/$id support issue. As I couldn't find anything in the issue queue I wanted to ask, are there any issues I could read up on and would there be a workaround? I tried looking for a way to set up a custom schema repo for the ReDoc instance, or a way to hook into reference resolving, but there does not seem to be anything like that.

[131706dulce]

https://developer.android.com/guide/topics/manifest/uses-sdk-element?hl=es-419#ApiLevels

[jeremyfiel]

I've just run into the $ref/$id support issue. As I couldn't find anything in the issue queue I wanted to ask, are there any issues I could read up on and would there be a workaround? I tried looking for a way to set up a custom schema repo for the ReDoc instance, or a way to hook into reference resolving, but there does not seem to be anything like that.

can you give an example of your $ref issue? what, exactly, are you referring to?