Ticketing & Marketing.
Die perfekte Verbindung.
Eine API für Ticketverkauf, Einlass-Management und Marketing-Aktivierung. Token holen, Events laden, Warenkorb füllen, bezahlen: vier Aufrufe hin, ein Webhook zurück.
curl https://aditus.dev/Demo_API/api/connect/token \ -u $CLIENT_ID:$CLIENT_SECRET \ -d "grant_type=client_credentials&scope=Shop" # → returns access_token curl https://aditus.dev/Demo_API/api/shop/v1/discovery/events \ -H "Authorization: Bearer $ACCESS_TOKEN" \ -H "Accept-Language: de-DE"
Das öffentliche ADITUS-Demo-System betreibt alle interaktiven Beispiele dieses Portals: Event-Discovery, Warenkorb, Checkout und Tickets laufen gegen eine echte Shop-API mit Live-Daten.
Sobald diese Seite im Browser lädt, werden die aktuelle Verfügbarkeit der Shop-API, ihrer vorgelagerten Dienste und die Response-Zeit live geprüft.
Sechs Dinge, für die dir dein Integrationsteam dankbar sein wird.
Konzipiert für CTOs und Plattform-Teams: Authentifizierung, Lokalisierung, Webhooks und Idempotenz, ohne Workarounds.
OAuth 2.0 Client Credentials
Kurzlebige Bearer-Tokens mit gescopeten Claims (Shop, TERP). Schlüssel jederzeit rotierbar.
Lokalisierung serienmäßig
Accept-Language setzen, und jedes Textfeld kommt übersetzt zurück. Die gewählte Sprache gilt durchgängig von der Eventliste bis zum Checkout.
Quicodes & Ticket-Links
Scanbare QR-Payloads mit einem Flag. Built-in Regex-Kategorien sortieren Scans direkt ins Reporting.
Echtzeit-Webhooks
30 Events zu Tickets, Carts, Zahlungen und Einlass. HMAC-SHA256 signiert, mit Exponential-Backoff erneut versucht.
Idempotent ab Werk
Idempotency-Key Header auf jedem Write. Wiederholungen liefern die ursprüngliche Antwort mit Log-ID.
Marketing-Events out-of-the-box
Conversions und Einlässe direkt nach GA4, Meta CAPI oder ins eigene Warehouse streamen.
Ich habe den größten Teil meines Berufslebens selbst Software gebaut. Dieses Portal ist das, was ich mir damals von jedem Anbieter gewünscht hätte.
Marc LuzoffCEO, GeschäftsführerIn vier Schritten live, im fünften bezahlt.
Token erzeugen
Client-Credentials gegen kurzlebigen Bearer-Token unter /connect/token tauschen. ~50 Min. cachen.
Events entdecken
Event-Katalog inkl. lokalisierter Namen, Slots und Preis-Sortimente abrufen. Filter nach Datum, Venue, Slug.
Cart aufbauen
Idempotenter Cart, Items per Artikel-ID oder Slug hinzufügen, Kunde anhängen, Zahlungsanbieter wählen.
Bestätigen & ausliefern
Cart sperren, Checkout ausführen, Quicodes + Ticket-Links erhalten. Webhook bei jedem Kauf.
curl https://aditus.dev/Demo_API/api/connect/token \ -u $CLIENT_ID:$CLIENT_SECRET \ -d "grant_type=client_credentials&scope=Shop" # → returns access_token curl https://aditus.dev/Demo_API/api/shop/v1/discovery/events \ -H "Authorization: Bearer $ACCESS_TOKEN" \ -H "Accept-Language: de-DE"
- Dein Backend ruft ADITUS auf:Token
POST /connect/tokenClient-Credentials rein, kurzlebiger Bearer raus. Secrets verlassen nie dein Backend.
- Dein Backend ruft ADITUS auf:Event Discovery
GET /shop/v1/discovery/eventsLokalisierter Katalog mit Events, Slots und Preis-Sortimenten.
- Dein Backend ruft ADITUS auf:Cart (idempotent)
POST /shop/v1/cartCart anlegen, Items hinzufügen, Käufer anhängen. Retries sind sicher: gleicher Cart, keine Duplikate.
- Dein Backend ruft ADITUS auf:Checkout
POST /shop/v1/cart/{id}/checkoutCart sperren und bezahlen. Die Antwort enthält Quicodes und Ticket-Links zur Auslieferung.
- ADITUS ruft dein Backend auf (asynchron):Webhookasynchron
POST https://your-backend/webhookNach jedem erfolgreichen Kauf ruft ADITUS deinen Endpoint auf, asynchron und unabhängig von der Checkout-Antwort.
Eine API ist ein Produkt und die Dokumentation ist ihre Benutzeroberfläche. Sie entscheidet, ob Menschen und KI-Agenten damit Werte schaffen können. Der Maßstab ist, was andere mit unserer API erreichen, ohne dabei auf unser internes Wissen angewiesen zu sein. Ohne sehr gute Dokumentation veröffentlichen wir höchstens ein Artefakt, aber kein Produkt.
Sebastian KlugeHead of ProductsAlle Endpoints, sauber gruppiert.
Vom OAuth-Token bis zum Webhook-Replay: 11 Bereiche, jede Anfrage mit Beispielen, Headern und Antworten dokumentiert.
Introduction
Der Einstieg in die ADITUS-API: Was die Plattform kann, wie die Bereiche zusammenspielen und wo du mit der Integration beginnst.
Guidelines
Die Konventionen der API: Aufbau von Requests und URIs, Authentifizierung per Basic oder OAuth, HTTP-Verben, Statuscodes und die Struktur der Antworten.
Just Entrance
ADITUS-Hardware lässt sich mit externen Registrierungsanbietern kombinieren. Es gibt verschiedene Wege, externe Systeme für einen reibungslosen Einlass vor Ort anzubinden.
Beispiel: externe Tickets importieren, automatisch abgleichen und sofort einlassbereit machen.
Just Entrance: Anwendungsfall →Ticket purchase & registration
Die Shop-API deckt alle Shop-Prozesse ab: Produkte finden, Nutzer verwalten sowie Warenkorb und Kauf abwickeln, inklusive Discovery zur Ermittlung der Systemkonfiguration.
Beispiel: kompletter Ticketkauf in deiner App. Sortiment laden, Warenkorb füllen, Käuferdaten erfassen, bezahlen.
Ticket purchase & registration: Anwendungsfall →Byndr
Byndr ist eine Produkt-API für nahtlose, sichere Verbindungen zwischen Teilnehmenden per Badge-Scan (QR-Code), für gerichtete und beidseitige Kontakte.
Survey
Eine Umfrage dient der systematischen Datenerhebung: eine Reihe von Fragen, um gezielt Informationen von Besuchenden zu sammeln, inklusive dynamischer Formulare.
Assets
Die Assets-API liefert die statischen Inhalte der Plattform: Bilder und Icons, Ticket-PDFs und Belege sowie Theme-Daten wie Logos, Banner und Farben, je Kontext aufgelöst.
Die Live-Demo zeigt, wie du Assets abrufst und verwendest.
Live-Demo öffnen →Webhooks
Webhooks übermitteln Daten in Echtzeit an externe Systeme. Damit bindest du Apps, APIs und Websites an, die auf bestimmte Ereignisse der ADITUS-Plattform reagieren.
Beispiel: Der Scan am Einlass feuert in Echtzeit einen Webhook; Salesforce, HubSpot & Co. starten Follow-ups automatisch.
Webhooks: Anwendungsfall →Business Intelligence
Ein lesender OData-v4-Feed, der dir alles, was dein Ticketing weiß, als vier analysefertige Datensätze liefert, gebaut für den Bulk-Load in dein eigenes Data Warehouse.
Beispiel: Dein Extrakt liest Verkäufe und Scans per OData v4 aus Live-Daten in dein Warehouse, sichtbar im Dashboard, während die Messe läuft.
Business Intelligence: Anwendungsfall →Erlebe die API live zum Anfassen.
Die Live-Demo führt dich durch eine vollständig modellierte Messe samt Sortimenten, Tickets, Warenkorb und Registrierung. Jeder Schritt zeigt die echte API-Anfrage und die Live-Antwort, ohne Kreditkarte.

