Zum Inhalt springen

Ticketing & Marketing.
Die perfekte Verbindung.

Eine API für Ticketverkauf, Einlass-Management und Marketing-Aktivierung — mit der Klarheit, die euer CTO erwartet.

18ms
P50 Latenz
99.99%
Uptime '25
565
Endpunkte
10
Bereiche
1 Mrd +
ANFR./JAHR
POST /terp/v1/import/ticketowners
curl https://api.aditus.dev/connect/token \
  -u $CLIENT_ID:$CLIENT_SECRET \
  -d "grant_type=client_credentials&scope=Shop"

# → returns access_token

curl https://api.aditus.dev/shop/v1/discovery/events \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Accept-Language: de-DE"
Demo-System
Live-Status
Nicht erreichbar
Das Demo-System antwortet gerade nicht.
Zuletzt geprüft: 09:15:09
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 euer 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 gesetzt — und jedes Textfeld kommt übersetzt zurück. Cultures durchlaufen Cart und 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 — by default

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
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://api.aditus.dev/connect/token \
  -u $CLIENT_ID:$CLIENT_SECRET \
  -d "grant_type=client_credentials&scope=Shop"

# → returns access_token

curl https://api.aditus.dev/shop/v1/discovery/events \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Accept-Language: de-DE"
  1. Euer Backend ruft ADITUS auf:
    Token
    POST /connect/token

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

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

    Lokalisierter Katalog mit Events, Slots und Preis-Sortimenten.

  3. Euer 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. Euer 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 euer Backend auf (asynchron):
    Webhookasynchron
    POST https://your-backend/webhook

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

Der gesamte Ablauf, Ende zu Ende — vier synchrone Aufrufe hin, ein asynchroner Webhook zurück.
Shop Micro Frontend

Der Ticketshop, nativ auf eurer Website.

Ein mount()-Aufruf bettet die komplette Kaufstrecke — Entdecken, Warenkorb, Registrierung, Checkout — direkt in eure Seite ein: ohne iFrame, im eigenen Markenlook per Design-Tokens, lokalisiert und responsiv ab Werk.

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

Alle Endpoints, sauber gruppiert.

Vom OAuth-Token bis zum Webhook-Replay — 10 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 ihr mit der Integration beginnt.

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.

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 eurer App — Sortiment laden, Warenkorb füllen, Käuferdaten erfassen, bezahlen.

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

Bevorzugt diese API gegenüber der veralteten Theme-API. Die Assets-API liefert statische Inhalte wie Bilder, Tickets und Belege sowie Theming-Informationen.

In der Live-Demo zeigen wir dir unter anderem, wie du die Assets abrufst und verwendest →

Webhooks

Webhooks übermitteln Daten in Echtzeit an externe Systeme. Damit bindet ihr 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.
Alle Bereiche ansehen →
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 Live-Antwort, ohne Kreditkarte.