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
+4-2
Original file line number
Diff line number
Diff line change
@@ -3531,6 +3531,8 @@ Version | Date | Notes
3531
3531
1.1 | 2012-08-22 | Release of Swagger 1.1
3532
3532
1.0 | 2011-08-10 | First release of the Swagger Specification
3533
3533
3534
+
## <a name="usingRFC6570Implementations"></a>Appendix C: Using RFC6570 Implementations
3535
+
3534
3536
## <a name="percentEncodingAndFormMediaTypes"></a>Appendix E: Percent-Encoding and Form Media Types
3535
3537
3536
3538
_**NOTE:** In this section, the `application/x-www-form-urlencoded` and `multipart/form-data` media types are abbreviated as `form-urlencoded` and `form-data`, respectively, for readability._
@@ -3552,7 +3554,7 @@ Reserved characters with no special meaning defined within a component can be le
3552
3554
However, other specifications can define special meanings, requiring percent-encoding for those characters outside of the additional special meanings.
3553
3555
3554
3556
The `form-urlencoded` media type defines special meanings for `=` and `&` as delimiters, and `+` as the replacement for the space character (instead of its percent-encoded form of `%20`).
3555
-
This means that while these three characters are reserved-but-allowed in query strings by RFC3986, the must be percent-encoded in `form-urlencoded` query strings except when used for their `form-urlencoded` purposes; see Appendix C for an example of handling `+` in form values.
3557
+
This means that while these three characters are reserved-but-allowed in query strings by RFC3986, the must be percent-encoded in `form-urlencoded` query strings except when used for their `form-urlencoded` purposes; see [Appendix C](#usingRFC6570Implementations) for an example of handling `+` in form values.
Style-based serialization is used in the [Parameter Object](#parameterObject) when `schema` is present, and in the [Encoding Object](#encodingObject) when at least one of `style`, `explode`, or `allowReserved` is present.
3579
-
See [Appendix C]() for more details of RFC6570's two different approaches to percent-encoding, including an example involving `+`.
3581
+
See [Appendix C](#usingRFC6570Implementations) for more details of RFC6570's two different approaches to percent-encoding, including an example involving `+`.
3580
3582
3581
3583
Content-based serialization is defined by the [Media Type Object](#mediaTypeObject), and used with the [Parameter Object](#parameterObject) when the `content` field is present, and with the [Encoding Object](#encodingObject) based on the `contentType` field when the style fields listed in the previous section are absent.
3582
3584
Each part is encoded based on the media type (e.g. `text/plain` or `application/json`), and must then be percent-encoded for use in a `form-urlencoded` string.
0 commit comments