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.0.md
+4-4Lines changed: 4 additions & 4 deletions
Original file line number
Diff line number
Diff line change
@@ -932,7 +932,7 @@ Field Name | Type | Description
932
932
<a name="parameterAllowEmptyValue"></a> allowEmptyValue | `boolean` | Sets the ability to pass empty-valued parameters. This is valid only for `query` parameters and allows sending a parameter with an empty value. Default value is `false`. If [`style`](#parameterStyle) is used, if behavior is `n/a`, the value of `allowEmptyValue` SHALL be ignored.
933
933
934
934
The rules for serialization of the parameter are specified in one of two ways.
935
-
For simpler scenarios, a [`style`](#parameterStyle) and [`schema`](#parameterSchema) can be used to describe the structure and syntax of the parameter.
935
+
For simpler scenarios, a [`schema`](#parameterSchema) and [`style`](#parameterStyle) can be used to describe the structure and syntax of the parameter.
936
936
937
937
Field Name | Type | Description
938
938
---|:---:|---
@@ -943,9 +943,9 @@ Field Name | Type | Description
943
943
<a name="parameterExample"></a>example | Any | Example of the media type. The example SHOULD match the specified schema and encoding properties if present. The `example` object is mutually exclusive to the `examples` object. Furthermore, if referencing a `schema` which contains an example, the `example` value SHALL _override_ the the example provided by the schema. To represent examples of media types that cannot naturally represented in JSON or YAML, a string value can be used to contain the example with escaping where necessary.
944
944
<a name="parameterExamples"></a>examples | Map[ `string`, [Example Object](#exampleObject) \| [Reference Object](#referenceObject)] | Examples of the media type. Each example SHOULD contain a value in the correct format as specified in the parameter encoding. The `examples` object is mutually exclusive to the `example` object. Furthermore, if referencing a `schema` which contains an example, the `examples` value SHALL _override_ the example provided by the schema.
945
945
946
-
For more complex scenarios a [Content Object](#contentObject) can be used to define the media type
947
-
and schema of the parameter. This option is mutually exclusive with the simple scenario
948
-
above. When `example` or `examples` are provided in conjunction with the `schema` object,
946
+
For more complex scenarios a [Content Object](#contentObject) can be used to define the media type and schema of the parameter.
947
+
A parameter MUST contain either a `schema` property, or a `content` property, but not both.
948
+
When `example` or `examples` are provided in conjunction with the `schema` object,
949
949
the example MUST follow the prescribed serialization strategy for the parameter.
0 commit comments