Skip to content

Address base URI for JSON Schema embedded in other documents  #837

Closed
@handrews

Description

@handrews

In the discussions around JSON Schema and OpenAPI Specification 3.1, we need to clarify the determination of the base URI for each of the embedded JSON Schema resources.

The OAS document has its own media type, and its own rules for determining a base URI. These fall under RFC 3986's "base URI embedded in the document" approach. We should probably update our own section 8.2.1 Initial Base URI to note that, in the case of a JSON Schema resource embedded in a document of another media type, the initial base URI is determined according to the rules of that media type.

This is philosophically consistent with what's already there, I believe, and would clarify an important use case. And would mean that specifications like OAS 3.1 would not have to call it out as a special case.

Also paging @webron @darrelmiller @philsturgeon

Metadata

Metadata

Assignees

Labels

Type

No type

Projects

No projects

Relationships

None yet

Development

No branches or pull requests

Issue actions