Skip to content

v3.2: Provide guidance for multiple contentType values #4744

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

Open
wants to merge 1 commit into
base: v3.2-dev
Choose a base branch
from

Conversation

handrews
Copy link
Member

@handrews handrews commented Jun 21, 2025

We have always allowed multiple contentType values in the Encoding Object, but do not provide any guidance on how to determine which to use when performing the encoding. This adds such guidance.

This has become more relevant with multipart/mixed support, as the only way to define a set of parts where the order of the media types is not predictable (perhaps because the number of each media type is variable) is to use itemEncoding and put all of the media types in contentType.

An example of this usage can be found in PR #4746.

(also fix a copy-paste error that left a + at the beginning of a line)

  • 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

We allow multiple `contentType` values in the Encoding Object,
but do not provide any guidance on how to determine which to use
when performing the encoding.  This adds such guidance.
@handrews handrews added this to the v3.2.0 milestone Jun 21, 2025
@handrews handrews requested review from a team as code owners June 21, 2025 01:15
@handrews handrews added the media and encoding Issues regarding media type support and how to encode data (outside of query/path params) label Jun 21, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
media and encoding Issues regarding media type support and how to encode data (outside of query/path params)
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant