-
Notifications
You must be signed in to change notification settings - Fork 9.2k
Closed
Labels
examplesrequests for more or better examples in the specificationrequests for more or better examples in the specificationparam serializationIssues related to parameter and/or header serializationIssues related to parameter and/or header serialization
Milestone
Description
The style values table has a type column which I assume indicates which data types can be serialized using that style (e.g. a deepObject style on a query parameter for any data type other than object would constitute an invalid spec), in the same way that I assume the in column determines which locations each style is valid in.
But this is not consistent with the examples, and further brings up some curiosities:
- The
simpleparameter style only supports arrays, yet it is the default style for path parameters and the only style for header parameters.- Is this supposed to mean header parameters are only ever allowed to be arrays? No primitives can ever be passed to a header parameter?
- There is an example path parameter object that uses the default style—
simple—that contradicts this by defining a schema with data typestring.
- In the style examples table
pipeDelimitedandspaceDelimitedboth offer examples of serialized objects, not just arrays, and thesimplestyle has examples of an object as well as a string primitive.
These contradictions imply that my initial assumption about the type column in the style values table is incorrect. But there is no explanation about what it is supposed to indicate, then.
lorenzosfarra and brozansk
Metadata
Metadata
Assignees
Labels
examplesrequests for more or better examples in the specificationrequests for more or better examples in the specificationparam serializationIssues related to parameter and/or header serializationIssues related to parameter and/or header serialization