diff --git a/spec.md b/spec.md index 6056065fa..aaeb146a7 100644 --- a/spec.md +++ b/spec.md @@ -209,19 +209,25 @@ that contains both context and data). [RFC 2046](https://tools.ietf.org/html/rfc2046) * For Media Type examples see [IANA Media Types](http://www.iana.org/assignments/media-types/media-types.xhtml) -### extensions -* Type: Map -* Description: This is for additional metadata and this does not have a - mandated structure. This enables a place for custom fields a producer or - middleware might want to include and provides a place to test metadata before - adding them to the CloudEvents specification. TBD - Determine a shorter - prefix for this (e.g. OpenAPI uses “x-”) +### application-properties +* Type: +* Description: A list of “key : value” pairs providing information about the event, which are + used by an event-based application. The “key : value” pairs should be in flat structure. + The value should be a string. There should be no duplication of keys. + One usage example: an application workflow can use a "key:value" to correlate multiple events + (from different event sources) asscociated with a serverless application workflow. * Constraints: - * OPTIONAL - * If present, MUST contain at least one entry + * MANDATORY + * MUST be in the format of pair. * Examples: - * authorization data - + application-properties + { + "building address": "12 Main Street, Copenhagen, Denmark, 123456" + "floor": "2" + "apartmentId": "345" + "sensor-location": "room1.window2" + } + ### data * Type: Arbitrary payload * Description: The event payload. The payload depends on the event-type,