Order Management System REST API - Event Audit Controller
The event/audit/between
URL provides access to the events generated by OMS views.
Retrieves the events between two positions in the event stream.
Section titled “Retrieves the events between two positions in the event stream.”GET /event/audit/between
Retrieves the events between two positions in the event stream for the requested views.
Requires the Audit
feature permission.
Query Parameters
Section titled “Query Parameters”Parameter | Expected | Description |
---|---|---|
from[<seq>] | Optional | Describes the starting position of a sequence (exclusive). Repeat for each feed involved in OMS. If omitted, defaults to 0 for all feeds. |
to[<seq>] | Required | Describes the ending position of a sequence (inclusive). Repeat for each feed involved in OMS. |
count | Optional | The maximum number of records to return. If omitted, returns every record. |
for | Optional | The SubscriptionType to return events for. Repeat for additional views. If omitted, supplies events for all views. |
snapshot | Optional | True to include starting snapshot events for the requested views. If omitted or false, no snapshot is supplied. |
Response
Section titled “Response”Code | Status | Description |
---|---|---|
200 | Success | Content is an array of EventMessage objects. |
403 | Failure | You supplied invalid owner or account values. |
Examples
Section titled “Examples”In this example, we retrieve the first 100 Transaction events for the following sequences
Sequence | From | To |
---|---|---|
oms | 100 | 200 |
foundry | 10 | 10 |
prodigy | 1 | 20 |
Note that for Foundry the From
and To
are identical, so no events will be provided.
curl --oauth2-bearer $AccessToken http://oms.hub/event/audit/between?from[prodigy]=1&from[oms]=100&from[foundry]=10&to[prodigy]=20&to[oms]=200&to[foundry]=10&count=100&for=Transactions