Messaging Service

Description

A messaging service to push event and seat changes in real-time.

Flow

Paciolan's internal systems will publish messages to Amazon SNS when changes occur to events or seats, which will then be consumed by its subscribers.

Event Message Request

HTTP HEADERS

Property	Type	Description
Authorization	String	Authorization with Basic Auth e.g.: Authorization: Basic dGVzdDp0ZXN0

Request Object

Property	Type	Description
data	Object	Request data
→ events	Array of Objects	Collection of events with changes
→ → accessId	String	Main/Parking event accessId
→ → seasonCode	String	Season code
→ → itemCode	String	Item code
→ → itemName	String	Item name; Precedence: 1. Internet Name 2. Item Name 3. Event name
→ → startDate	Date	Date part (before "T" delimiter) of ISO 8601 compliant date.
→ → startTime	Time / Enum ["TBD"]	Time part (after "T" delimiter) of ISO 8601 compliant time. Can also return TBD if no start time is set.
→ → endDate	Date	Date part (before "T" delimiter) of ISO 8601 compliant date.
→ → endTime	Time / Enum ["TBD"]	Time part (after "T" delimiter) of ISO 8601 compliant time. Can also return TBD if no end time is set.
→ → facilityCode	String	Facility code
→ → facilityName	String	Facility Name
metadata	Object of Strings	Request metadata
→ messageEntity	Enum ["events"]	The name of the entity pushing the changes
→ pacOrganizationId	Integer	The client's data account ID
→ requestId	String	A unique ID provided for debugging purposes

Seats Message Request

HTTP HEADERS

Property	Type	Description
Authorization	String	Authorization with Basic Auth e.g.: Authorization: Basic dGVzdDp0ZXN0

Request Object

Property	Type	Description
data	Object	Request data
→ seats	Array of Objects	Collection of seats with changes
→ → accessId	String	The accessId for the event the seat is located in, which will always be the main/home or parking event.
→ → season	String	Season Code
→ → item	String	Item Code
→ → section	String	Section code. (LEVEL:SECTION)
→ → row	String	Row
→ → seat	String	Seat
→ → status	Enum ["LOCK", "UNLOCK"]	Seat status. e.g. Active listings need to be removed from integrator's site if the message received for such listed ticket receives a status of UNLOCK
metadata	Object of Strings	Request metadata
→ messageEntity	Enum ["seats"]	The name of the entity pushing the changes
→ pacOrganizationId	Integer	The client's data account ID
→ requestId	String	A unique ID provided for debugging purposes

Examples

Event Request

Body

{
  "data": {
    "events": [
      {
        "accessId": "999:F23:F01",
        "seasonCode": "F23",
        "itemCode": "F01",
        "itemBasis": "SINGLE",
        "itemName": "Football Game 1",
        "startDate": "2023-05-20",
        "startTime": "20:30:00Z",
        "endDate": null,
        "endTime": null,
        "facilityCode": "ABC",
        "facilityName": "Pavilion"
      },
      {
        "accessId": "999:F23:P01",
        "seasonCode": "F23",
        "itemCode": "P01",
        "itemBasis": "SINGLE",
        "itemName": "Parking for Football Game 1",
        "startDate": "2023-05-20",
        "startTime": "20:30:00Z",
        "endDate": null,
        "endTime": null,
        "facilityCode": "ABC",
        "facilityName": "Pavilion"
      }
    ]
  },
  "metadata": {
    "messageEntity": "events",
    "pacOrganizationId": 999,
    "requestId": "a1b2c3"
  }
}

Seats Request

Headers

Body

{
  "data": {
    "seats": [
      {
        "accessId": "129:FB23:FB01",
        "season": "FB23",
        "item": "FB01",
        "section": "ES:9",
        "row": "30",
        "seat": "24",
        "status": "UNLOCK"
      },
      {
        "accessId": "129:FB223:FB01",
        "season": "FB223",
        "item": "FB01",
        "section": "ES:9",
        "row": "30",
        "seat": "25",
        "status": "UNLOCK"
      }
    ]
  },
  "metadata": {
    "messageEntity": "seats",
    "pacOrganizationId": 129,
    "requestId": "a1b2c3"
  }
}