Skip to content

Commit

Permalink
Use K-Eventing-Http-Attr instead
Browse files Browse the repository at this point in the history
  • Loading branch information
Jimmy Lin committed Jan 12, 2021
1 parent 8981340 commit 018fd4b
Showing 1 changed file with 18 additions and 7 deletions.
25 changes: 18 additions & 7 deletions docs/spec/data-plane.md
Original file line number Diff line number Diff line change
Expand Up @@ -91,13 +91,24 @@ delivered.
CloudEvents received by Sink MAY have
[Distributed Tracing Extension Attribute](https://github.com/cloudevents/spec/blob/v1.0/extensions/distributed-tracing.md).

### Event reply header

An event sender, including Source and Broker and Channel, SHOULD include
the event reply header `K-Eventing-Accept-Reply: response` in an event delivery
request if it supports response events. If no event reply header is present
or the header is present but does not include the value `response`,
the Sink SHOULD assume that response events are not supported.
### HTTP Attributes

An event sender, including Source and Broker and Channel, MUST include
all the non-default HTTP attributes with header key `K-Eventing-Http-Attr` in
every event delivery to specify
what HTTP features it can support. Without a certain attribute, the receiver
MUST assume the corresponding HTTP feature is not supported. A list of HTTP
attributes can be found below:

| Attributes | HTTP Feature Description |
| ------------------ | ------------------------------------------------------------------------- |
| `callable` | If the event sender supports event reply in HTTP response. |

An example is that a broker supporting event reply MUST send events with
an additional header `K-Eventing-Http-Attr: ["callable"]` so that the sink connected
to the broker knows event replies will be accepted. While a source
may send events without the header, in which case the sink connected directly
to the source will assume that any event reply will be dropped.

### Data plane contract for Sources

Expand Down

0 comments on commit 018fd4b

Please sign in to comment.