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.

provides
provides
hosts
hosts
EventDate
EventDate
Event
Event
Location
Location


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​

For fine-grained control of the timeslots and capacity of an event, eventDate resources can be used. These are useful for seated events or events spanning multiple timeslots, such as festivals. An eventDate resource defines a specific timeslot and capacity for an event, allowing more detailed management. Each eventDate resource associates with a single event, while an event can have zero or more associated eventDate resources.

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.