How to subscribe on changes of context

Apart from getting information using queries in a synchronous way (as illustrated in the “How to update and query context information” section above), Context Consumers can also get context information in an asynchronous way using notifications. In this scenario, the Context Broker GE is “programmed” to send notifications upon given conditions (specified in the subscription request).

In the case of NiceEating, the application backend could use a subscription so each time a new review is cast by any user, the backend gets notified (in order to recalculate restaurant average rating and publish it back in the Context Broker GE).

POST <cb_host>:<cb_port>/v2/subscriptions

Headers:

{
  'Content-Type':     'application/json',
  'Fiware-Service':   'tourguide'
}

Payload:

{
  "description": "Update average rating",
  "subject": {
    "entities": [
      {
        "idPattern": ".*",
        "type": "Review"
      }
    ],
    "condition": {
      "attrs": [
        "ratingValue"
      ]
    }
  },
  "notification": {
    "http": {
      "url": "http://backend.niceeating.foo.com:1028/ratings4"
    },
    "attrs": [
      "ratingValue",
      "itemReviewed"
    ]
  },
  "expires": "2020-04-05T14:00:00.00Z",
  "throttling": 5
}

Another case would be an application that subscribes to changes in average ratings of a given restaurant. This may be useful for restaurant owners in order to know how their restaurants score is evolving.

POST <cb_host>:<cb_port>/v2/subscriptions

Headers:

{
  'Content-Type':     'application/json',
  'Fiware-Service':   'tourguide'
}

Payload:

{
  "description": "Get aggregateRating for Elizalde",
  "subject": {
    "entities": [
      {
        "id": "0115206c51f60b48b77e4c937835795c33bb953f",
        "type": "Restaurant"
      }
    ],
    "condition": {
      "attrs": [
        "aggregateRating"
      ]
    }
  },
  "notification": {
    "http": {
      "url": "http://myapp.foo.com:1028/restaurant_average_scorings"
    },
    "attrs": [
      "aggregateRating",
      "name"
    ]
  },
  "expires": "2020-04-05T14:00:00.00Z",
  "throttling": 5
}