@PLUGIN@ - /plugins/@PLUGIN@/events/ REST API

Events Endpoints

List Events

‘GET /plugins/@PLUGIN@/events/’

Lists events that have happened. Will list the n most recent events where n is the limit specified in the plugin configuration. See stream-events command documentation for the types definition: cmd-stream-events

Request

  GET /plugins/@PLUGIN@/events/ HTTP/1.0

Response

  HTTP/1.1 200 OK
  Content-Disposition: attachment
  Content-Type: application/json;charset=UTF-8
  {
    "type":"patchset-created",
    ...
  }
  {
    "type":"comment-added",
    ...
  }

Error

  HTTP/1.1 503 Service Unavailable

This error message will be shown if the main database is unavailable. Events will not be listed until the main database is back in service.

Options

--From Date/Time (t1) : Limit the results to the events that happened after the specified date/time.

--To Date/Time (t2) : Limit the results to the events that happened before the specified date/time.

Format: the date/time arguments are formatted as follows - “yyyy-MM-dd HH:mm:ss”. Can optionally only specify the date - “yyyy-MM-dd”.

ACCESS

Any authenticated user.

EXAMPLES

Query the change events which happened between 2014-09-01 and 2014-10-01

curl --user joe:secret http://host:port/plugins/@PLUGIN@/events/?t1=2014-09-01;t2=2014-10-01

Query the change events which happened between 2014-10-29 10:00:00 and 2014-10-29 11:00:00

curl --user joe:secret “http://host:port/plugins/@PLUGIN@/events/?t1=2014-10-29%2010%3A00%3A00.000;t2=2014-10-29%2011%3A00%3A00”