Description
Hello there. Can we get some clarification on:
- cookie parameter example values using form serialization
- rfc6570 template clarification for all style and parameter type combos?
I am asking because the swagger docs show examples:
https://swagger.io/docs/specification/serialization/
And in the query parameter examples we see:
| style | explode | rfc6570 template | array_value |
|---|---|---|---|
| form | true | {?id*} | ?id=3&id=4&id=5 |
| form | false | {?id} | ?id=3,4,5 |
Yet for cookie parameters values lack the ? prefix.
This is not consistent with the examples given in rcf6570 for form style {?var} or {&var} expansion
Those expansions require the ? or & prefix with values like:
{?var} -> {?id} ->
{?id*} ?id=3&id=4&id=5
{?id} -> ?id=3,4,5
{&var} -> {&id} ->
{&var*} &id=3&id=4&id=5
{&var} &id=3,4,5
If we are meant to exclude those prefixes, and use form styles please provide the uri templates and direction.
The openapi spec omits the ? prefix from the form examples of serialized data though they are needed in style form query parameter serialization.
Header Question:
Also, what should None serialize to in a header? In a path it is empty string. In a header should the value be empty string or should it be omitted?
Related issues: