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.md
+2-15Lines changed: 2 additions & 15 deletions
Original file line number
Diff line number
Diff line change
@@ -48,7 +48,6 @@ Additional utilities can also take advantage of the resulting files, such as tes
48
48
- [Encoding Object](#encodingObject)
49
49
- [Responses Object](#responsesObject)
50
50
- [Response Object](#responseObject)
51
-
- [Callbacks Object](#callbacksObject)
52
51
- [Callback Object](#callbackObject)
53
52
- [Headers Object](#headersObject)
54
53
- [Example Object](#exampleObject)
@@ -758,7 +757,8 @@ Field Name | Type | Description
758
757
<a name="operationParameters"></a>parameters | [[Parameter Object](#parameterObject) \| [Reference Object](#referenceObject)] | A list of parameters that are applicable for this operation. If a parameter is already defined at the [Path Item](#pathItemParameters), the new definition will override it but can never remove it. The list MUST NOT include duplicated parameters. A unique parameter is defined by a combination of a [name](#parameterName) and [___location](#parameterIn). The list can use the [Reference Object](#referenceObject) to link to parameters that are defined at the [OpenAPI Object's components/parameters](#componentsParameters).
759
758
<a name="operationRequestBody"></a>requestBody | [Request Body Object](#requestBodyObject) \| [Reference Object](#referenceObject) | The request body applicable for this operation. The `requestBody` is only supported in HTTP methods where the HTTP 1.1 specification [RFC7231](https://tools.ietf.org/html/rfc7231#section-4.3.1) has explicitly defined semantics for request bodies. In other cases where the HTTP spec is vague, `requestBody` SHALL be ignored by consumers.
760
759
<a name="operationResponses"></a>responses | [Responses Object](#responsesObject) | **Required.** The list of possible responses as they are returned from executing this operation.
761
-
<a name="operationCallbacks"></a>callbacks | [Callbacks Object](#callbacksObject) | The list of possible callbacks as they are returned from executing this operation.
760
+
<a name="operationCallbacks"></a>callbacks | Map[`string`, [Callback Object](#callbackObject) \| [Reference Object](#referenceObject)] | A map of possible out-of band callbacks related to the parent operation. Each value in the map is a [Callback Object](#callbackObject) that describes a request that may be initiated by the API provider and the expected responses.
761
+
The key value used to identify the callback object is an expression, evaluated at runtime, that identifies a URL to use for the callback operation.
762
762
<a name="operationDeprecated"></a>deprecated | `boolean` | Declares this operation to be deprecated. Consumers SHOULD refrain from usage of the declared operation. Default value is `false`.
763
763
<a name="operationSecurity"></a>security | [[Security Requirement Object](#securityRequirementObject)] | A declaration of which security mechanisms can be used for this operation. The list of values includes alternative security requirement objects that can be used. Only one of the security requirement objects need to be satisfied to authorize a request. This definition overrides any declared top-level [`security`](#oasSecurity). To remove a top-level security declaration, an empty array can be used.
764
764
<a name="operationServers"></a>servers | [[Server Object](#serverObject)] | An alternative `server` array to service this operation. If an alternative `server` object is specified at the Path Item Object or Root level, it will be overridden by this value.
@@ -1757,19 +1757,6 @@ Response with no return value:
A map of possible out-of band callbacks related to the parent operation.
1763
-
Each value in the map is a [Callback Object](#callbackObject) that describes a request that may be initiated by the API provider and the expected responses.
1764
-
The key value used to identify the callback object is an expression, evaluated at runtime, that identifies a URL to use for the callback operation.
1765
-
1766
-
##### Patterned Fields
1767
-
Field Pattern | Type | Description
1768
-
---|:---:|---
1769
-
<a name="callbackName"></a>{name} | [Callback Object](#callbackObject) \| [Reference Object](#referenceObject) | A Callback Object used to define a callback request and expected responses
1770
-
1771
-
This object can be extended with [Specification Extensions](#specificationExtensions).
1772
-
1773
1760
#### <a name="callbackObject"></a>Callback Object
1774
1761
1775
1762
A map of possible out-of band callbacks related to the parent operation.
0 commit comments