API for events

[thejhh]

GET /api/v1/grid/:grid/events

Listen for events on the specified grid. This endpoint uses HTTP long polling,
so the connection will remain open until an event is triggered or a timeout is
reached. When an event is triggered, the server will send a response with the
details of the event, and the connection will close. The client can then make
another request to listen for further events.

This endpoint accepts the following query parameters:

• timeout: The maximum duration, in seconds, to keep the connection open
  before timing out. The default is 30 seconds.
• lastEventId: The ID of the last event received by the client. The server
  will only send events with a higher ID. If this parameter is not provided, the
  server will send all events.

TODO

• Documentation
• Unit tests
• Implementation
• Reference documentation
• System tests
• Tutorial