Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

should Cookie headers be ignored by 'parameters'? #2819

Open
karenetheridge opened this issue Dec 6, 2021 · 2 comments
Open

should Cookie headers be ignored by 'parameters'? #2819

karenetheridge opened this issue Dec 6, 2021 · 2 comments
Assignees
Labels
headers param serialization Issues related to parameter and/or header serialization
Milestone

Comments

@karenetheridge
Copy link
Contributor

In https://spec.openapis.org/oas/v3.1.0#fixed-fields-9: "If in is "header" and the name field is "Accept", "Content-Type" or "Authorization", the parameter definition SHALL be ignored." Should this also include "Cookie" and/or "Set-Cookie", since these are handled by the 'cookie' parameter type?

Similarly for the header object at https://spec.openapis.org/oas/v3.1.0#header-object (and I noticed that "Accept", "Content-Type" or "Authorization" are not excluded there, and probably should be).

@handrews handrews added the param serialization Issues related to parameter and/or header serialization label Jan 27, 2024
@handrews handrews self-assigned this May 23, 2024
@handrews handrews added this to the v3.0.4 milestone May 23, 2024
@handrews
Copy link
Member

I think for the Header Object the "follows the structure of the Parameter Object" is sufficient, because the forbidden names are in the field definition. But we should say something about Cookie. I'm going with its behavior being undefined (for compatibility purposes - we can't make it illegal).

@handrews
Copy link
Member

I think it's possible to describe Set-Cookie in a Header Object as it is a response header and its use is discussed in issue #1237, so I'm just going to make a note about Cookie.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
headers param serialization Issues related to parameter and/or header serialization
Projects
None yet
Development

No branches or pull requests

2 participants