3.0md callback responses?

[willdady]

The Operation object has a non-camelCase field labeled callback responses can we get a better example of this? Is this a typo and should be callbackResponses? Is the following right?

callbackResponses:
  myWebhook:
    '$request.url':
      post:
        body:
          name: postResponse
          schema:
            $ref: '#/definitions/SomePayload'
        responses:
          200:
            description: webhook successfully processed an no retries will be performed

[darrelmiller]

Thanks for pointing that out. I'm going to change that to just say callbacks. The callback is an operation object that contains both outgoing request and response, so saying "callback responses" is just confusing.

[willdady]

Great. Thanks for the quick response. I'm working on an implementation and was a bit stumped when I came across that.

[darrelmiller]

If you are implementing, you probably want to check out the PR I submitted today #891 that attempts to define the variable syntax of the callback key. Hopefully, that will get finalized tomorrow.

[darrelmiller]

Changes to name of property are now included in PR.