Skip to content

Commit f4c2f93

Browse files
committed
Remove 3.0-specific encoding guidance (3.1.1 adjustment to 3857)
These lines were added to clarify in 3.0 what was already fixed properly in 3.1. Remove most of them, but keep (and reword) the explanation of how they correlate with how the Parameter Object fields are used.
1 parent 9739dfe commit f4c2f93

1 file changed

Lines changed: 2 additions & 12 deletions

File tree

versions/3.1.1.md

Lines changed: 2 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1815,18 +1815,8 @@ Field Name | Type | Description
18151815

18161816
See also [Appendix C: Using RFC6570 Implementations](#usingRFC6570Implementations) for additional guidance.
18171817

1818-
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.
1819-
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:
1820-
1821-
* The value of `contentType`, whether it is explicitly defined or has the default value, is to be ignored
1822-
* 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
1823-
1824-
However, if all three of `style`, `explode`, and `allowReserved` fields are absent, it is RECOMMENDED that:
1825-
1826-
* All three keywords are to be entirely ignored, rather than treated as having their default values
1827-
* 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
1828-
1829-
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.
1818+
Note that the presence of at least one of `style`, `explode`, or `allowReserved` with an explicit value is equivalent to using `schema` with `in: query` Parameter Objects.
1819+
The absence of all three of those fields is the equivalent of using `content`, but with the media type specified in `contentType` rather than through a Media Type Object.
18301820

18311821
###### Encoding `multipart` Media Types
18321822

0 commit comments

Comments
 (0)