-
Notifications
You must be signed in to change notification settings - Fork 87
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
OpenAPI media type #117
Comments
Ref: [https://github.com/OAI/OpenAPI-Specification/issues/110](OpenAPI Issue 110) The MIME Types for OpenAPI have been finalized. With an optional version: |
The media types have been agreed by the OAI TSC, but are not yet in the media type register of IANA. However, since they are in the vnd branch, it should not take long. I will create a pull request once the media types are in the IANA register. |
It would be helpful if we included the media types that the TSC did agree to. The risk is that since they have not been registered, the TSC could change their minds. |
It is unclear when or if OAI will register the media types. For now we will use latest ones agreed by the TSC and add a note about their status. |
New activity wrt media types: https://www.ietf.org/archive/id/draft-polli-rest-api-mediatypes-00.html |
Previously it was planned by OAI to register
application/openapi+json
(which we use in the current draft), but OAI seems to have changed its mind. See the latest entries in OAI/OpenAPI-Specification#110 which suggest:application/vnd.oai.openapi
(YAML variant)application/vnd.oai.openapi+json
(JSON only variant)As these media types are not registered with IANA yet, I think we should keep the current media type for now, but update it once it has been registered with IANA.
The text was updated successfully, but these errors were encountered: