Skip to content

Commit 9a82f73

Browse files
committed
Reword default handling (review feedback)
Thanks to @notEthan for the comments!
1 parent b0ecaad commit 9a82f73

File tree

1 file changed

+9
-2
lines changed

1 file changed

+9
-2
lines changed

versions/3.0.4.md

+9-2
Original file line numberDiff line numberDiff line change
@@ -1664,8 +1664,15 @@ If `format: byte` is used along with setting a different `Content-Transfer-Encod
16641664
###### Encoding the `application/x-www-form-urlencoded` Media Type
16651665

16661666
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
16691676

16701677
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.
16711678

0 commit comments

Comments
 (0)