Events

You are here:
< All Topics

Overview

Events are the main objects in gigeasy. With our API you can access:

  • all events OR
  • all past events OR
  • all future events OR
  • events in specified range

for a band or a user specified by the corresponding API key.

Please note, that you will only get events that are in status “Contract sent” or “Booked”.

Endpoints

Get all events of a user for a given API key

https://app.gigeasy.de/api/v1/users/<API key>/events?datetype=all

Get past events of a band for given API key

https://app.gigeasy.de/api/v1/bands/<API key>/events?datetype=past

Get future events of a user for a given API key

https://app.gigeasy.de/api/v1/users/<API key>/events?datetype=future

Get events between fromDate and toDate (including the specified dates) for given API key

https://app.gigeasy.de/api/v1/users/<API key>/events?datetype=range&fromDate=2020-01-01&toDate=2020-06-30

Full HTML example

The following code is a complete example HTML page embedding data using the gigeasy API. It will give you a result like this:

gigeasy API Integration

Please be aware that you have to exchange the API key „f0fdce89-673f-479d-b227-a63c304c7ae2″ (which belongs to our Sample Band) against your personal API key to make it work (see Authentication).

<!DOCTYPE html>
<html lang="en">

<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>gigeasy API example</title>
</head>

<body>
    <!-- Font awesome icons-->
    <link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.7.2/css/all.css"
        integrity="sha384-fnmOCqbTlWIlj8LyTjo7mOUStjsKC4pOpQbqyi7RrhN7udi9RwhKkMHpvLbHG9Sr" crossorigin="anonymous">
    <script type="text/javascript">
        // gigeasy allows the following values for datetype:
        // - all    = Get all events
        // - future = Get all future events (today and later)
        // - past 	= Get all past events (today and earlier)
        // - range&fromDate=2020-01-01&toDate=2020-06-30 = Get all events from 01.01.2020 to 30.06.2020 (including the from- and to-date)

        var index = ["past", "future"];

        for (var i = 0; i < index.length; i++) {

            var sortOrder;

            if (index[i] == "past") {
                sortOrder = "&sortOrder=desc";
            }
            else {
                sortOrder = "&sortOrder=asc";
            }

            var url = "https://app.gigeasy.de/api/v1/bands/f0fdce89-673f-479d-b227-a63c304c7ae2/events?datetype=" + index[i] + sortOrder;
            let request = new XMLHttpRequest();

            request.open("GET", url);

            let datetype = index[i];
            request.onreadystatechange = function () {
                if (request.readyState === XMLHttpRequest.DONE) {
                    if (request.status >= 200 && request.status < 400) {
                        var response = JSON.parse(request.response);
                        if (response.status == 'error') {

                            renderError(response.status, response.message);
                        }
                        else {
                            renderEvents(response.data, datetype);
                        }
                    } else {
                        renderError(request.status, request.statusText);
                    }
                }
            }
            request.setRequestHeader("Content-Type", "application/x-www-form-urlencoded");
            request.send();
        }

        function renderEvents(events, datetype) {
            var contentArea = document.getElementById(datetype);

            events.forEach(event => {
                let eventDate = new Date(event.date);
                let eventLocation = !event.location ? "" : event.location
                let eventLocationLink = !event.mapLink ? '' : '<a href=' + event.mapLink + ' title="Auf Karte anzeigen" target="_blank"><i class="fas fa-map-marker-alt event_location_link"></i></a>'

                if (event.type === "private") {
                    contentArea.insertAdjacentHTML('beforeend', '<li class="event_list_item"><div class="event_date"><div class="event_day">' + getGermanWeekday(eventDate) + '</div><div class="event_date_dd_mm">' + dateToGermanDateString(eventDate) + '</div></div><div class="private_event">Geschlossene Gesellschaft</div></li><hr class="event_divider">');
                }
                else {
                    // default values
                    let eventName = !event.name ? "" : event.name;
                    let eventLocation = !event.location ? "" : event.location;
                    let eventZip = !(event.address && event.address.zipCode) ? "" : event.address.zipCode;
                    let eventCity = !(event.address && event.address.city) ? "" : event.address.city;

                    contentArea.insertAdjacentHTML('beforeend', '<li class="event_list_item"><div class="event_date"><div class="event_day">' + getGermanWeekday(eventDate) + '</div><div class="event_date_dd_mm">' + dateToGermanDateString(eventDate) + '</div></div><div class="event_description"><div>' + eventName + '</div><div>  ' + eventLocation + ' ' + eventLocationLink + '</div><div>' + eventZip + " " + eventCity + ' </div></div></li><hr class="event_divider">');
                }
            });
        }

        function renderError(status) {

            var para = document.createElement("p");
            var node = document.createTextNode("Fehler beim Aufruf der Veranstaltungsübersicht. Statuscode: " + status);
            para.appendChild(node);

            var element = document.getElementById("content_area");
            element.appendChild(para);
        }

        function getGermanWeekday(date) {

            if (date) {
                var weekdayNames = ['So.', 'Mo.', 'Di.', 'Mi.', 'Do.', 'Fr.', 'Sa.'];
                var weekday = date.getDay();
                var weekdayName = weekdayNames[weekday];

                return weekdayName;
            } else {
                return null;
            }
        }
        function dateToGermanDateString(date) {

            if (date) {
                var day = date.getDate();
                var month = date.getMonth() + 1; //Be careful! January is 0 not 1
                var year = date.getFullYear();

                if (day < 10) {
                    day = '0' + day;
                }

                if (month < 10) {
                    month = '0' + month;
                }

                return day + "." + month + "." + year;
            } else {
                return null;
            }
        }
    </script>
    <h1>Upcoming events</h1>
    <ul id="future"></ul>
    <h1>Past events</h1>
    <ul id="past"></ul>


    <style>
        html{
            font-family: "Helvetica Neue", sans-serif;
        }
        .event_list {
            list-style: none;
        }

        .event_list_item {
            margin: 10px 0px 10px 0px;
            display: flex;
        }

        .event_date {
            display: flex;
        }

        .event_day {
            width: 1.5rem;
        }

        .event_date_dd_mm {
            padding: 0px 5px 0px 5px;
            color: white;
            background-color: #FAB701;
            margin-left: 0.75rem;
        }

        .event_description {
            margin-left: 2.25rem;
            flex-grow: 1;
        }

        .event_location_link {
            color: #FAB701;
        }

        .private_event {
            margin-left: 2.25rem;
            font-style: italic;
        }

        .event_divider {

            border-top: 1px solid;
        }
    </style>
</body>

</html>

Previous Authentication
Table of Contents