Skip to content

Commit 0f7a910

Browse files
Update src/oas.md
Co-authored-by: Henry Andrews <andrews_henry@yahoo.com>
1 parent 551560f commit 0f7a910

1 file changed

Lines changed: 2 additions & 1 deletion

File tree

src/oas.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4885,11 +4885,12 @@ When using `style` and/or `explode` to produce a `multipart/form-data` body, the
48854885
Note that while [RFC7578](https://datatracker.ietf.org/doc/html/rfc7578) allows using [[RFC3986]] percent-encoding in "file names", it does not otherwise address the use of percent-encoding within the format.
48864886
Users are expected to provide names and data with any escaping necessary for conformance with RFC7578 already applied.
48874887

4888-
Due to these restrictions, the only `style` and `explode` combinations that can be used in `multipart/form-data` are:
4888+
Due to these restrictions, the only `style` and `explode` combinations that can safely be used in `multipart/form-data` are:
48894889
- `style: form` with any primitive type
48904890
- `style: form` and `explode: false` with arrays and objects (note that due to the omission of the query string name, this serialization is equivalent to `style: simple`)
48914891
- `style: spaceDelimited` or `style: pipeDelimited` and `explode: false` with arrays and objects
48924892

4893+
The behavior of other combinations with `multipart/form-data` is undefined.
48934894
Note also that not all RFC6570 implementations support all four levels of operators, all of which are needed to fully support the OpenAPI Specification's usage.
48944895
Using an implementation with a lower level of support will require additional manual construction of URI Templates to work around the limitations.
48954896

0 commit comments

Comments
 (0)