You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: versions/3.1.1.md
+5-5Lines changed: 5 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2760,9 +2760,9 @@ This object MAY be extended with [Specification Extensions](#specification-exten
2760
2760
2761
2761
##### Extended Validation with Annotations
2762
2762
2763
-
JSON Schema draft 2020-12 supports [collecting annotations](https://datatracker.ietf.org/doc/html/draft-bhutton-json-schema-00#section-7.7.1), including [treating unrecognized keywords as annotations](https://datatracker.ietf.org/doc/html/draft-bhutton-json-schema-00#section-6.5).
2763
+
JSON Schema Draft 2020-12 supports [collecting annotations](https://datatracker.ietf.org/doc/html/draft-bhutton-json-schema-00#section-7.7.1), including [treating unrecognized keywords as annotations](https://datatracker.ietf.org/doc/html/draft-bhutton-json-schema-00#section-6.5).
2764
2764
OAS implementations MAY use such annotations, including [extensions](https://spec.openapis.org/registry/extension/) not recognized as part of a declared JSON Schema vocabulary, as the basis for further validation.
2765
-
Note that JSON Schema draft 2020-12 does not require an `x-` prefix for extensions.
2765
+
Note that JSON Schema Draft 2020-12 does not require an `x-` prefix for extensions.
2766
2766
2767
2767
###### Non-validating constraint keywords
2768
2768
@@ -2773,7 +2773,7 @@ Extended validation is one way that these constraints MAY be enforced.
2773
2773
2774
2774
The `readOnly` and `writeOnly` keywords are annotations, as JSON Schema is not aware of how the data it is validating is being used.
2775
2775
Validation of these keywords MAY be done by checking the annotation, the read or write direction, and (if relevant) the current value of the field.
2776
-
[JSON Schema Validation draft 2020-12 §9.4](https://datatracker.ietf.org/doc/html/draft-bhutton-json-schema-validation-00#section-9.4) defines the expectations of these keywords, including that resource (described as the "owning authority") MAY either ignore a `readOnly` field or treat it as an error.
2776
+
[JSON Schema Validation Draft 2020-12 §9.4](https://datatracker.ietf.org/doc/html/draft-bhutton-json-schema-validation-00#section-9.4) defines the expectations of these keywords, including that a resource (described as the "owning authority") MAY either ignore a `readOnly` field or treat it as an error.
2777
2777
2778
2778
An example of where ignoring a "written" `readOnly` field might be appropriate is a PUT request where the field is included but the value has not been changed, since the alternative of leaving out the field would result in the field's deletion per [[RFC7231]].
2779
2779
@@ -2933,10 +2933,10 @@ additionalProperties:
2933
2933
2934
2934
```yaml
2935
2935
oneOf:
2936
-
- const: rgb
2936
+
- const: RGB
2937
2937
title: Red, Green, Blue
2938
2938
description: Specify colors with the red, green, and blue additive color model
2939
-
- const: cmyk
2939
+
- const: CMYK
2940
2940
title: Cyan, Magenta, Yellow, Black
2941
2941
description: Specify colors with the cyan, magenta, yellow, and black subtractive color model
0 commit comments