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: versions/3.0.4.md
+5-5Lines changed: 5 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -267,7 +267,7 @@ OpenAPI Description authors SHOULD consider how text using such extensions will
267
267
### <aname="relativeReferences"></a>Relative References in URLs
268
268
269
269
Unless specified otherwise, all properties that are URLs MAY be relative references as defined by [RFC3986](https://tools.ietf.org/html/rfc3986#section-4.2).
270
-
Relative references are resolved using the URLs defined in the [`Server Object`](#serverObject) as a Base URI.
270
+
Relative references are resolved using the URLs defined in the [Server Object](#serverObject) as a Base URI.
271
271
272
272
Relative references used in `$ref` are processed as per [JSON Reference](https://tools.ietf.org/html/draft-pbryan-zyp-json-ref-03), using the URL of the current document as the base URI. See also the [Reference Object](#referenceObject).
273
273
@@ -747,13 +747,13 @@ components:
747
747
#### <a name="pathsObject"></a>Paths Object
748
748
749
749
Holds the relative paths to the individual endpoints and their operations.
750
-
The path is appended to the URL from the [`Server Object`](#serverObject) in order to construct the full URL. The Paths MAY be empty, due to [ACL constraints](#securityFiltering).
750
+
The path is appended to the URL from the [Server Object](#serverObject) in order to construct the full URL. The Paths MAY be empty, due to [ACL constraints](#securityFiltering).
751
751
752
752
##### Patterned Fields
753
753
754
754
Field Pattern | Type | Description
755
755
---|:---:|---
756
-
<a name="pathsPath"></a>/{path} | [Path Item Object](#pathItemObject) | A relative path to an individual endpoint. The field name MUST begin with a forward slash (`/`). The path is **appended** (no relative URL resolution) to the expanded URL from the [`Server Object`](#serverObject)'s `url` field in order to construct the full URL. [Path templating](#pathTemplating) is allowed. When matching URLs, concrete (non-templated) paths would be matched before their templated counterparts. Templated paths with the same hierarchy but different templated names MUST NOT exist as they are identical. In case of ambiguous matching, it's up to the tooling to decide which one to use.
756
+
<a name="pathsPath"></a>/{path} | [Path Item Object](#pathItemObject) | A relative path to an individual endpoint. The field name MUST begin with a forward slash (`/`). The path is **appended** (no relative URL resolution) to the expanded URL from the [Server Object](#serverObject)'s `url` field in order to construct the full URL. [Path templating](#pathTemplating) is allowed. When matching URLs, concrete (non-templated) paths would be matched before their templated counterparts. Templated paths with the same hierarchy but different templated names MUST NOT exist as they are identical. In case of ambiguous matching, it's up to the tooling to decide which one to use.
757
757
758
758
This object MAY be extended with [Specification Extensions](#specificationExtensions).
759
759
@@ -1862,7 +1862,7 @@ However, documentation is expected to cover a successful operation response and
1862
1862
The `default` MAY be used as a default response object for all HTTP codes
1863
1863
that are not covered individually by the specification.
1864
1864
1865
-
The `Responses Object` MUST contain at least one response code, and it
1865
+
The Responses Object MUST contain at least one response code, and it
1866
1866
SHOULD be the response for a successful operation call.
1867
1867
1868
1868
##### Fixed Fields
@@ -2324,7 +2324,7 @@ In this example, the JSON string had to be serialized before encoding it into th
2324
2324
2325
2325
#### <a name="linkObject"></a>Link Object
2326
2326
2327
-
The `Link object` represents a possible design-time link for a response.
2327
+
The Link Object represents a possible design-time link for a response.
2328
2328
The presence of a link does not guarantee the caller's ability to successfully invoke it, rather it provides a known relationship and traversal mechanism between responses and other operations.
2329
2329
2330
2330
Unlike _dynamic_ links (i.e. links provided **in** the response payload), the OAS linking mechanism does not require link information in the runtime response.
0 commit comments