You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/oas.md
+2-2Lines changed: 2 additions & 2 deletions
Original file line number
Diff line number
Diff line change
@@ -5215,7 +5215,7 @@ paths:
5215
5215
/foo:
5216
5216
get:
5217
5217
requestBody:
5218
-
$ref: "shared#/components/requestBodies/Foo"
5218
+
$ref: "shared/foo#/components/requestBodies/Foo"
5219
5219
```
5220
5220
5221
5221
Assume the retrieval URI for the following document is `https://git.example.com/shared/blob/main/shared/foo.yaml`:
@@ -5249,7 +5249,7 @@ In this example, the retrieval URIs are irrelevant because both documents define
5249
5249
For the relative `$ref` in the first document, it is resolved against `$self` to produce `https://example.com/shared/foo#/components/requestBodies/Foo`.
5250
5250
The portion of that URI before the '#' matches the `$self` of the second document, so the reference target is resolved to `#/components/requestBodies/Foo` in that second document.
5251
5251
5252
-
In that document, the `$ref` in the Request Body Object is resolved using that document's `$self` as the base URI, producing `https://example.com/schemas/foo`.
5252
+
In that document, the `$ref` in the Request Body Object is resolved using that document's `$self` as the base URI, producing `https://example.com/api/schemas/foo`.
5253
5253
This matches the `$id` at `#/components/schemas/Foo/$id` so it points to that Schema Object.
5254
5254
That Schema Object has a subschema with `$ref: bar`, which is resolved against the `$id` to produce `https://example.com/schemas/bar`, which matches the `$id` at `#/components/schemas/Bar/$id`.
0 commit comments