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.4.md
+9-2
Original file line number
Diff line number
Diff line change
@@ -1664,8 +1664,15 @@ If `format: byte` is used along with setting a different `Content-Transfer-Encod
1664
1664
###### Encoding the `application/x-www-form-urlencoded` Media Type
1665
1665
1666
1666
The role of `contentType` with `application/x-www-form-urlencoded` request bodies was not described in detail in version 3.0.3 and earlier of this specification.
1667
-
To match the intent of these fields and be compatible with version 3.1 of this specification, it is RECOMMENDED that whenever any of `style`, `explode`, or `allowReserved` are present with an explicit values, that the value of `contentType`, whether it is explicitly defined or has the default value, be ignored.
1668
-
Likewise, if all three of those fields are absent, it is RECOMMENDED that they be ignored, and that encoding be based on `contentType` alone.
1667
+
To match the intent of these fields and be compatible with version 3.1 of this specification, it is RECOMMENDED that whenever any of `style`, `explode`, or `allowReserved` are present with an explicit value:
1668
+
1669
+
* The value of `contentType`, whether it is explicitly defined or has the default value, is to be ignored
1670
+
* If any of `style`, `explode`, or `allowReserved` are _not_ present with explicit values, then they are to be treated as if they were present with their default values
1671
+
1672
+
However, if all three of `style`, `explode`, and `allowReserved` fields are absent, it is RECOMMENDED that:
1673
+
1674
+
* All three keywords are to be entirely ignored, rather than treated as having their default values
1675
+
* Encoding is to be based on `contentType` alone, whether it is present with an explicit value or absent and treated as having its default value
1669
1676
1670
1677
This makes the presence of at least one of `style`, `explode`, or `allowReserved` with an explicit value equivalent to using `schema` with `in: query` Parameter Objects, and their absence the equivalent of using `content`, but with the media type specified in `contentType` rather than through a Media Type Object.
0 commit comments