Skip to main content

Overview

​​OpenTicket is a system focused on event and ticket management. It is therefore not surprising that events and tickets are at the heart of the system. In the following sections, you will learn how to set up simple events and how to create tickets for those events. All of this can also be done through the dashboard. However, the documentation focuses on setting up all the necessary resources through the API.

Resources​

​​OpenTicket uses many resources, many of which are connected in one way or another. It is not uncommon that a resource cannot be created if another resource does not exist, or that a resource cannot be deleted if another resource still exists. To make this clear, this section of the documentation describes the resources that are used to set up events and tickets.

EventDate
EventDate
Event
Event
Location
Location
provides
provides
has
has


The Entity Relation (ER) diagram shown above visualizes a small subset of the resources used by the ​OpenTicket system and shows how these resources relate to each other. The remainder of this section explains in more detail why these resources are related.

Location​

There are many locations in the world where events can take place, but the ​OpenTicket system does not know all of them by default. This makes sense because storing all of these locations would be a big waste of memory. Instead, the ​OpenTicket system requires you to create these locations by hand. To do this, you create a location resource that stores relevant information about a location, such as its name and address. It is possible to store much more information in a location, as the next sections of the documentation will show.

Event​

Analogous to the location, you must also create a resource for an event. An event resource stores relevant information about an event, such as its name and description. As the diagram above shows, an event and a location are related. This makes sense since every event must take place somewhere. In a sense, a location provides the ability to host an event. The ​OpenTicket system reflects this as well: you must first create a location, and only then an event can be created. This event then uses the location to indicate where an event will take place.

After you create a location, you can associate many event resources with it. Thus, each location can be associated with zero or more event resources. On the other hand, an event is associated with only one location, which means that an event cannot take place at two different locations.

EventDate​

Each event takes place on a certain date and lasts for a certain time. It may sound logical to include this information in the event. However, this limits the ​OpenTicket system in several ways. Therefore, the ​OpenTicket system uses the eventDate resource instead. This resource stores the start and end date and time, and can be associated with an event to indicate when the event begins and ends.

It is clear that the eventDate and event resources are related. As described above, an event must first be created, then an eventDate can be created and associated with an event. It is possible to associate multiple eventDate resources with a single event. This allows the sale of day-based tickets for events that take place on multiple days, but will not be discussed in detail in the following sections. On the other hand, an eventDate can only be associated with one specific event.

Notes​

In the following sections, you will create the above-mentioned resources in the ​OpenTicket system through the API. To keep this as clear as possible, only required fields for creating these resources are shown. However, in practice, there is much more information that can be added to these resources. The API reference mentions all additional fields that can be added to these resources.