|
1031 | 1031 | <tr> |
1032 | 1032 | <td><a id="operationRequestBody"> </a>requestBody</td> |
1033 | 1033 | <td style="text-align:center"><a href="#requestBodyObject">Request Body Object</a> | <a href="#referenceObject">Reference Object</a></td> |
1034 | | -<td>The request body applicable for this operation. The <code>requestBody</code> is fully supported in HTTP methods where the HTTP 1.1 specification [[!RFC7231]] has explicitly defined semantics for request bodies. In other cases where the HTTP spec is vague (such as [GET]section-4.3.1), [HEAD]section-4.3.2) and [DELETE]section-4.3.5)), <code>requestBody</code> is permitted but does not have well-defined semantics and SHOULD be avoided if possible.</td> |
| 1034 | +<td>The request body applicable for this operation. The <code>requestBody</code> is fully supported in HTTP methods where the HTTP 1.1 specification [[!RFC7231]] has explicitly defined semantics for request bodies. In other cases where the HTTP spec is vague (such as <a href="https://tools.ietf.org/html/rfc7231#section-4.3.1">GET</a>, <a href="https://tools.ietf.org/html/rfc7231#section-4.3.2">HEAD</a> and <a href="https://tools.ietf.org/html/rfc7231#section-4.3.5">DELETE</a>), <code>requestBody</code> is permitted but does not have well-defined semantics and SHOULD be avoided if possible.</td> |
1035 | 1035 | </tr> |
1036 | 1036 | <tr> |
1037 | 1037 | <td><a id="operationResponses"> </a>responses</td> |
|
1650 | 1650 | <tr> |
1651 | 1651 | <td><a id="requestBodyContent"> </a>content</td> |
1652 | 1652 | <td style="text-align:center">Map[<code>string</code>, <a href="#mediaTypeObject">Media Type Object</a>]</td> |
1653 | | -<td><strong>REQUIRED</strong>. The content of the request body. The key is a media type or [media type range]appendix-D) and the value describes it. For requests that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*</td> |
| 1653 | +<td><strong>REQUIRED</strong>. The content of the request body. The key is a media type or <a href="https://tools.ietf.org/html/rfc7231#appendix-D">media type range</a> and the value describes it. For requests that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*</td> |
1654 | 1654 | </tr> |
1655 | 1655 | <tr> |
1656 | 1656 | <td><a id="requestBodyRequired"> </a>required</td> |
|
2161 | 2161 | <tr> |
2162 | 2162 | <td><a id="responseContent"> </a>content</td> |
2163 | 2163 | <td style="text-align:center">Map[<code>string</code>, <a href="#mediaTypeObject">Media Type Object</a>]</td> |
2164 | | -<td>A map containing descriptions of potential response payloads. The key is a media type or [media type range]appendix-D) and the value describes it. For responses that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*</td> |
| 2164 | +<td>A map containing descriptions of potential response payloads. The key is a media type or <a href="https://tools.ietf.org/html/rfc7231#appendix-D">media type range</a> and the value describes it. For responses that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*</td> |
2165 | 2165 | </tr> |
2166 | 2166 | <tr> |
2167 | 2167 | <td><a id="responseLinks"> </a>links</td> |
|
2628 | 2628 | </section><section><h4><span id="runtimeExpression">Runtime Expressions</span></h4> |
2629 | 2629 | <p>Runtime expressions allow defining values based on information that will only be available within the HTTP message in an actual API call. |
2630 | 2630 | This mechanism is used by <a href="#linkObject">Link Objects</a> and <a href="#callbackObject">Callback Objects</a>.</p> |
2631 | | -<p>The runtime expression is defined by the following [ABNF] syntax</p> |
| 2631 | +<p>The runtime expression is defined by the following <a href="https://tools.ietf.org/html/rfc5234">ABNF</a> syntax</p> |
2632 | 2632 | <pre class="nohighlight"><code> |
2633 | 2633 | expression = ( <span class="hljs-string">"$url"</span> / <span class="hljs-string">"$method"</span> / <span class="hljs-string">"$statusCode"</span> / <span class="hljs-string">"$request."</span> source / <span class="hljs-string">"$response."</span> source ) |
2634 | 2634 | source = ( header-reference / query-reference / path-reference / body-reference ) |
|
0 commit comments