Skip to content

Commit 9c04640

Browse files
committed
Fix: #110. Don't need new parameter.
1 parent b4350f9 commit 9c04640

File tree

1 file changed

+14
-0
lines changed

1 file changed

+14
-0
lines changed

draft-ietf-httpapi-rest-api-mediatypes.md

+14
Original file line numberDiff line numberDiff line change
@@ -251,6 +251,20 @@ Interoperability requirements for media type
251251
registrations are discussed in Section 4.6 of {{!MEDIATYPE=RFC6838}}
252252
and 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

256270
Security requirements for media type

0 commit comments

Comments
 (0)