Es gibt Situationen, in denen möchte man auf seiner Webseite anzeigen, dass Tickets ausverkauft sind. Dazu kann man die API nutzen und sich z.B. mit einem einfachen Javascript die Information auf die Webseite holen.

Wir nutzen dazu den Ticket-Kalender, wie er in der API-Dokumentation [1] beschrieben ist. Wichtig: damit man auch die gleichen Daten zieht wie der Ticket-Shop, muss der X-SHOP-URL-Header korrekt gesetzt sein. Wie das genau geht, haben wir in einem einfachen Javascript-Beispiel einmal zusammengefasst:

var url;
url = "https://demo.gomus.de/api/v4/tickets/calendar"

function allFalse(t) { 
    for (var i in t) {
        if (t[i] === true) return false;
    }
    return true;
}

function updateAvailabilies () {
  $.ajax({
    url: url,
    headers: { 'X-SHOP-URL': 'demo-shop.gomus.de' },
    data: {
      start_at:"2020-05-13",
      end_at: "2020-05-23"
    },
    success: function( data ) {
  if(allFalse(data["data"])){
    alert( "Ausverkauft!" );
  }else{
    alert( "Nur noch wenige Tickets übrig!" );
  }
}
});
  
}

 
updateAvailabilies();

Hinweis: das Beispiel nutzt JQuery und triggert nur einen Alert. Anstelle eines Alerts kann man auch geschickt Texte auf der Webseite ändern oder weitere Aktionen durchführen. Das Prinzip ist auch serverseitig z.B. mit PHP lösbar und bietet so auch bessere Unterstützung für die Barrierefreiheit.

Die Parameter “start_at” und “end_at” sollten den Zeitraum angeben, für den die Info gilt, und sollten nie länger als 30 Tage sein. Durch die in der Dokumentation aufgeführten Filter nach bestimmten Ticket-IDs kann diese Logik auch noch viel tiefer integriert und auf nur ein bestimmtes Angebot reduziert werden.

[1] https://giantmonkey.github.io/gomus-api-doc/public_api.html#calendar-for-tickets