Skip to content

Commit a845c00

Browse files
committed
Updates based comments.
1 parent 1597a0b commit a845c00

File tree

1 file changed

+6
-6
lines changed

1 file changed

+6
-6
lines changed

versions/3.0.md

+6-6
Original file line numberDiff line numberDiff line change
@@ -1752,7 +1752,7 @@ Content-Length: 123
17521752
17531753
{
17541754
"failedUrl" : "http://clientdomain.com/failed"
1755-
"successUrls : [
1755+
"successUrls" : [
17561756
"http://clientdomain.com/fast",
17571757
"http://clientdomain.com/medium",
17581758
"http://clientdomain.com/slow"
@@ -1779,12 +1779,12 @@ $response.header.Location | http://example.org/subscription/1
17791779

17801780
##### Callback Object Example
17811781

1782-
A callback to the URL specified by the `url` property in the request body.
1782+
A callback to the URL specified by the `id` and `email` property in the request body.
17831783

17841784

17851785
```yaml
17861786
myWebhook:
1787-
'http://notificationServer.com?transactionId={$request.body#/id}&email={$request.body#/email}}':
1787+
'http://notificationServer.com?transactionId={$request.body#/id}&email={$request.body#/email}':
17881788
post:
17891789
requestBody:
17901790
description: Callback payload
@@ -1884,15 +1884,15 @@ The presence of a link does not guarantee the caller's ability to successfully i
18841884

18851885
As opposed to _dynamic_ links (i.e. links provided **in** the response payload), the OAS linking mechanism does not require that link information be provided in a specific response format at runtime.
18861886

1887-
For computing links, and providing instructions to execute them, a [runtime expression](#runtimeExpression) is used for accessing values in a response and using them as parameters while invoking the linked operation.
1887+
For computing links, and providing instructions to execute them, a [runtime expression](#runtimeExpression) is used for accessing values in an operation and using them as parameters while invoking the linked operation.
18881888

18891889
##### Fixed Fields
18901890

18911891
Field Name | Type | Description
18921892
---|:---:|---
1893-
<a name="linkOperationRef"></a>operationRef | `string` | a relative or absolute reference to an OAS operation. This field is mutually exclusive with the `operationId` field, and must point to the fragment of a valid OAS definition.
1893+
<a name="linkOperationRef"></a>operationRef | `string` | a relative or absolute reference to an OAS operation. This field is mutually exclusive with the `operationId` field, and MUST point to an [Operation Object](#operationObject).
18941894
<a name="linkOperationId"></a>operationId | `string` | the name of an _existing_, resolvable OAS operation, as defined with a unique `operationId`. This field is mutually exclusive with the `operationRef` field. Relative `operationRef` values MAY be used to locate an existing [Operation Object](#operationObject) in the OAS.
1895-
<a name="linkParameters"></a>parameters | Map[`string` \| Any \| [{expression}](#runtimeExpression)] | A map representing parameters to pass to an operation as specified with `operationId` or identified via `operationRef`. The key is the parameter name to be used, whereas the value can be a constant or an expression to be evaluated and passed to the linked operation.
1895+
<a name="linkParameters"></a>parameters | Map[`string`, Any \| [{expression}](#runtimeExpression)] | A map representing parameters to pass to an operation as specified with `operationId` or identified via `operationRef`. The key is the parameter name to be used, whereas the value can be a constant or an expression to be evaluated and passed to the linked operation.
18961896
<a name="linkDescription"></a>description | `string` | a description of the link, supports [CommonMark syntax](http://spec.commonmark.org/).
18971897
<a name="linkServer"></a>server | [Server Object](#serverObject) | a server object to be used by the target operation.
18981898

0 commit comments

Comments
 (0)