Skip to content

Commit c48dd1a

Browse files
committed
More minimal wording regarding "format" validation.
1 parent 25d82a1 commit c48dd1a

File tree

1 file changed

+1
-1
lines changed

1 file changed

+1
-1
lines changed

versions/3.1.1.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -146,7 +146,7 @@ Data types in the OAS are based on the types supported by the [JSON Schema Speci
146146
Note that `integer` as a type is also supported and is defined as a JSON number without a fraction or exponent part.
147147
Models are defined using the [Schema Object](#schemaObject), which is a superset of JSON Schema Specification Draft 2020-12.
148148

149-
<a name="dataTypeFormat"></a>As defined by the [JSON Schema Validation specification](https://tools.ietf.org/html/draft-bhutton-json-schema-validation-00#section-7.3), data types can have an optional modifier property: `format`. Note that by default, JSON Schema draft 2020-12 validators _do not_ validate `format`, but instead treat it as an annotation. Support for `format` validation, either in best-effort form with the [default `format-annotation` vocabulary](https://datatracker.ietf.org/doc/html/draft-bhutton-json-schema-validation-00#section-7.2.1), or with the less-commonly-implemented [`format-assertion` vocabulary](https://datatracker.ietf.org/doc/html/draft-bhutton-json-schema-validation-00#section-7.2.2), varies among JSON Schema validator implementations.
149+
<a name="dataTypeFormat"></a>As defined by the [JSON Schema Validation specification](https://tools.ietf.org/html/draft-bhutton-json-schema-validation-00#section-7.3), data types can have an optional modifier property: `format`. As described in that specification, `format` is treated as a non-validating annotation by default; the ability to validate `format` varies across implementations.
150150

151151
OAS defines additional formats to provide fine detail for primitive data types.
152152

0 commit comments

Comments
 (0)