Zum Inhalt springen

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.

18ms
P50 Latenz
99.99%
Uptime '25
610
Endpunkte
11
Bereiche
1 Mrd +
ANFR./JAHR
POST /connect/token · GET /shop/v1/discovery/events
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"
Demo-System
Live-Status
Live-Prüfung im Browser

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.

Live-Prüfung startet beim Seitenaufruf
Vertrauen & integriert von
Deutsche TelekomDeutsche MesseMesse FrankfurtMesse EssenMesse StuttgartDeutsche Landwirtschafts-Gesellschaft (DLG)NürnbergMesseMesse BremenMesse MünchenMesse Offenburg-OrtenauRX Global
Gebaut für technische Entscheider

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.

AUTH

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.

i18n

Quicodes & Ticket-Links

Scanbare QR-Payloads mit einem Flag. Built-in Regex-Kategorien sortieren Scans direkt ins Reporting.

ACCESS

Echtzeit-Webhooks

30 Events zu Tickets, Carts, Zahlungen und Einlass. HMAC-SHA256 signiert, mit Exponential-Backoff erneut versucht.

EVENTS

Idempotent ab Werk

Idempotency-Key Header auf jedem Write. Wiederholungen liefern die ursprüngliche Antwort mit Log-ID.

RELIABILITY

Marketing-Events out-of-the-box

Conversions und Einlässe direkt nach GA4, Meta CAPI oder ins eigene Warehouse streamen.

ACTIVATION

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.

Porträt von Marc Luzoff, CEO und Geschäftsführer von ADITUSMarc LuzoffCEO, Geschäftsführer
Quickstart

In vier Schritten live, im fünften bezahlt.

1

Token erzeugen

Client-Credentials gegen kurzlebigen Bearer-Token unter /connect/token tauschen. ~50 Min. cachen.

2

Events entdecken

Event-Katalog inkl. lokalisierter Namen, Slots und Preis-Sortimente abrufen. Filter nach Datum, Venue, Slug.

3

Cart aufbauen

Idempotenter Cart, Items per Artikel-ID oder Slug hinzufügen, Kunde anhängen, Zahlungsanbieter wählen.

4

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"
  1. Dein Backend ruft ADITUS auf:
    Token
    POST /connect/token

    Client-Credentials rein, kurzlebiger Bearer raus. Secrets verlassen nie dein Backend.

  2. Dein Backend ruft ADITUS auf:
    Event Discovery
    GET /shop/v1/discovery/events

    Lokalisierter Katalog mit Events, Slots und Preis-Sortimenten.

  3. Dein Backend ruft ADITUS auf:
    Cart (idempotent)
    POST /shop/v1/cart

    Cart anlegen, Items hinzufügen, Käufer anhängen. Retries sind sicher: gleicher Cart, keine Duplikate.

  4. Dein Backend ruft ADITUS auf:
    Checkout
    POST /shop/v1/cart/{id}/checkout

    Cart sperren und bezahlen. Die Antwort enthält Quicodes und Ticket-Links zur Auslieferung.

  5. ADITUS ruft dein Backend auf (asynchron):
    Webhookasynchron
    POST https://your-backend/webhook

    Nach jedem erfolgreichen Kauf ruft ADITUS deinen Endpoint auf, asynchron und unabhängig von der Checkout-Antwort.

Der gesamte Ablauf, Ende zu Ende: vier synchrone Aufrufe hin, ein asynchroner Webhook zurück.

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.

Porträt von Sebastian Kluge, Head of Products bei ADITUSSebastian KlugeHead of Products
Shop Micro-Frontend

Der Ticketshop, der sich wie deine Website anfühlt.

Deine Besucher stöbern, wählen ihre Tickets und schließen den Kauf ab, ohne deine Website zu verlassen; eingebunden mit wenigen Zeilen Code. Design-Tokens tragen deinen Markenlook in jeden Schritt, responsiv und lokalisiert ab Werk.

Experience-Days-Eventseite mit eingebettetem Ticketshop: Ticketkategorien, Artikeldetails, Preise und Mengenauswahl

Für deinen Stack gebaut

Offene Integration

  • Light DOM: kein iFrame, kein Shadow DOM
  • React 18 und 19
  • Framework-agnostisch über mount(container, config)
  • Semantische CSS-Hooks und Design-Tokens
  • Live-Wechsel von Sprache und Kultur

Sicherer Betrieb

  • Dokumentiertes Session- und Authentifizierungsmodell
  • Server-to-Server-Erzeugung der Session-Tokens
  • Konkrete Content-Security-Policy-Anforderungen
  • Payment-Page-Architektur reduziert den PCI-Scope

Produktionsreif

  • Payment-Redirects mit sicherer Fortsetzung der Journey
  • Host-Callbacks und serverseitige Webhooks
  • Optionale GA4-E-Commerce-Events
  • Kompatibel mit SSR-Hosts wie Next.js und Nuxt
  • Quellpaket oder versioniertes, selbst gehostetes Bundle

Neben unseren leistungsstarken APIs für Backend-Integrationen ist das Shop Micro-Frontend ein wichtiger Baustein für moderne Ticketing-Projekte. Es lässt sich in kürzester Zeit integrieren. Styling Tool und Integrationstester beschleunigen dabei die ersten Schritte spürbar.

Porträt von Marc Ehbrecht, Team Lead Integration & Consulting bei ADITUSMarc EhbrechtTeam Lead Integration & Consulting
API-Referenz

Alle Endpoints, sauber gruppiert.

Vom OAuth-Token bis zum Webhook-Replay: 11 Bereiche, jede Anfrage mit Beispielen, Headern und Antworten dokumentiert.

Introduction

Introduction

Der Einstieg in die ADITUS-API: Was die Plattform kann, wie die Bereiche zusammenspielen und wo du mit der Integration beginnst.

Guidelines

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

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

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

Byndr ist eine Produkt-API für nahtlose, sichere Verbindungen zwischen Teilnehmenden per Badge-Scan (QR-Code), für gerichtete und beidseitige Kontakte.

Survey

Survey

Eine Umfrage dient der systematischen Datenerhebung: eine Reihe von Fragen, um gezielt Informationen von Besuchenden zu sammeln, inklusive dynamischer Formulare.

Assets

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

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

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 →
Live-Demo

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.