File tree Expand file tree Collapse file tree 1 file changed +14
-0
lines changed
Expand file tree Collapse file tree 1 file changed +14
-0
lines changed Original file line number Diff line number Diff line change @@ -251,6 +251,20 @@ Interoperability requirements for media type
251251registrations are discussed in Section 4.6 of {{!MEDIATYPE=RFC6838}}
252252and in the Interoperability Considerations of the "+yaml" Structured Syntax Suffix.
253253
254+ # # Media type of referenced resources
255+
256+ An OpenAPI Description can reference external resources
257+ that are not OpenAPI Documents (e.g., JSON Schema documents).
258+ Clients should be aware that
259+ even if they request a specific media type for those resources
260+ (e.g., `Accept : application/openapi+yaml; version=3.1`),
261+ the server might only be able to provide a more generic media type.
262+
263+ For example, a server that publishes a JSON Schema file,
264+ which can be referenced by both OpenAPI and JSON Schema documents,
265+ might choose to use the more generic `application/yaml` media type
266+ instead of managing multiple specific media types for the same resource.
267+
254268# Security Considerations {#sec}
255269
256270Security requirements for media type
You can’t perform that action at this time.
0 commit comments