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

A way to clarify that family of mediatypes can be returned #583

Open
petrochenko-pavel-a opened this issue Oct 14, 2016 · 0 comments

Comments

@petrochenko-pavel-a
Copy link
Contributor

commented Oct 14, 2016

Imagine api that returns a set of json or xml based media types (for example using vendor tree
type / vnd. media type name [+suffix])

At this moment only way to represent this in RAML is to ommit all media type information except of suffix and us application/json and application/xml media types. So if client checks actual media type of response it might be pretty confused by seing vnd.***+json in the HTTP response.

My suggestion is that we should have some predefined way to pattern media types, and allow users to write something like in their API descriptions.
mediaType: application/*+json

Regards,
Pavel

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
2 participants
You can’t perform that action at this time.