How to call the API

BlobUris endpoint

URL: https://event-archive.eu.guestline.app/api/BlobUris/{eventStream}/{groupId}/{siteId}
Method: GET
Parameters:

  • eventStream: name of the stream we want to download. List of available streams below.

  • groupId: Id for the group (tenant) the site we want to download data belongs to.

  • siteId: Id for the site.

Authentication
A X-API-KEY header with a valid key must be provided in the request.

Response format

JSON Payload with this structure:

{ "snapshot": "LATEST_SNAPSHOT_URL", "snapshotMetadata": { "itemCount": ITEM_COUNT, "sizeInBytes": SIZE_IN_BYTES }, "eventLogs": ["EVENT_LOG1_URL", "EVENT_LOG2_URL",...] }

  • snapshot: contains the URL for the lastest snapshot generated for that site and event stream.

  • eventLogs: contains the list of URLs for all the event logs (deltas) since the latest snapshot was generated.

URLs returned by this API are links to download blobs containing the data. Snapshot blobs are compressed, event logs are not. URLs are valid for 24 hours.
Format of the uncompressed data is new line delimited JSON.

We can provide examples in C# and typescript on how to uncompress and process the data:

C# example project

LogUris endpoint

URL: https://event-archive.eu.guestline.app/api/LogUris/{eventStream}/{groupId}/{siteId}?from={fromDate}
Method: GET
Parameters:

  • eventStream: name of the stream we want to download. List of available streams below.

  • groupId: Id for the group (tenant) the site we want to download data belongs to.

  • siteId: Id for the site.

  • fromDate: date from when we want to get event log files

Authentication
A X-API-KEY header with a valid key must be provided in the request.

Response format

JSON Payload with this structure:

{ "eventLogs": ["EVENT_LOG1_URL", "EVENT_LOG2_URL",...] }

  • eventLogs: contains the list of URLs for all the event logs (deltas) since fromDate (inclusive).

URLs returned by this API are links to download blobs containing the data. URLs are valid for 24 hours.
Format of the uncompressed data is new line delimited JSON.

List of available event streams:

  • fintransactions

  • maintenancewindows: information about rooms out of service/deducted from stock

  • roomcombinations: information about rooms that are part of the hotel room stock, but that are not physical rooms but combination of other rooms

  • roompicks: bookings

  • rooms

  • siteinformations

  • enquiries

  • eventbookingallotments

  • eventbookingreservations

  • allotments

  • blockdays

  • statuscodes

Other event streams that are not currently available but we could add:

There are other events we could publish, like profiles, rates, room types.... If there is something you are missing that you would like to get, let us know and we will check if we can add it.

NOTE:

Data in the blobs consist of raw events. So in some cases, structure of the JSON objects can be complex and subject to changes.
EA users of this API must not share the structure of the raw data or any detail about this API with any third party.