Skip to content

v3.2: Port of percent-encoding-related fixes from 3.1.2 #4863

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

Merged
merged 6 commits into from
Aug 14, 2025

Conversation

handrews
Copy link
Member

This ports the following PRs, each in their own commit (@ralfhandl this was easily done because of the lack of interspersed merge commits 🙂 ), in the following order:

Once this is merged, I can finish the style: cookie PR, and fix allowReserved to only apply to in values of path and query, and do some other related 3.2-specific tweaks that I did not want to mix with the approved PRs.

  • schema changes are included in this pull request
  • schema changes are needed for this pull request but not done yet
  • no schema changes are needed for this pull request

@handrews handrews added this to the v3.2.0 milestone Aug 13, 2025
@handrews handrews requested review from a team as code owners August 13, 2025 16:45
@handrews handrews added clarification requests to clarify, but not change, part of the spec param serialization Issues related to parameter and/or header serialization media and encoding Issues regarding media type support and how to encode data (outside of query/path params) headers approved pr port PRs that just port an approved PR to another version labels Aug 13, 2025
Research has determined that percent-encoding was never intended
to apply to this media type.
After much debate and research, we agreed that percent-encoding
was never meant to be applied to headers.

Exactly how to handle RFC6570 and cookie parameters remains TBD.
For now, this preserves (but streamlines) the existing guidance
for cookies.
After adding a new section on percent-encoding guidance, this
updates the examples and other supplemental text to match it.
ralfhandl
ralfhandl previously approved these changes Aug 13, 2025
@ralfhandl ralfhandl requested a review from a team August 13, 2025 20:30
Copy link
Contributor

@lornajane lornajane left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you

@lornajane lornajane merged commit 2a86e81 into OAI:v3.2-dev Aug 14, 2025
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
approved pr port PRs that just port an approved PR to another version clarification requests to clarify, but not change, part of the spec headers media and encoding Issues regarding media type support and how to encode data (outside of query/path params) param serialization Issues related to parameter and/or header serialization
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants