-
-
Notifications
You must be signed in to change notification settings - Fork 781
Open
Labels
Description
OpenAPI lags behind JSON Schema, which means OpenAPI APIs do not benefit from the latest fixes and improvements to the latter.
For example:
- JSON Schema Draft 4's
patternPropertiesis not supported in OpenAPI, even though the latter is based on Draft 5 (Add support for patternProperties in schemas OAI/OpenAPI-Specification#687). additionalProperties: falseis not compatible with OpenAPI's inheritance model usingallOf[1]. This is blocking for strict validation of JSON request bodies that depend on inheritance (JSON request bodies are not strictly validated #837).- Similar issues exist when combining
nullable,readOnly, andwriteOnlywith OpenAPI's inheritance model.
It would be nice if we could already use x-oas-draft-alternateSchemas to specify other schemas to address some of these issues, until alternativeSchema is available in OpenAPI 3.1 (OAI/OpenAPI-Specification#1736).
Related issue: Redocly/redoc#482
[1] https://stackoverflow.com/questions/22689900/json-schema-allof-with-additionalproperties
Reactions are currently unavailable