Demander un accès API

Billetterie & marketing,
parfaitement connectés.

Une seule API pour la vente de billets, la gestion des entrées et l'activation marketing — avec la clarté que votre CTO attend.

Lire le quickstart →ExemplesOuvrir dans Postman
18ms
Latence P50
99.99%
Uptime '25
565
Endpoints
10
Sections
1 Md +
REQ./AN
●POST /terp/v1/import/ticketowners
curl {{API_BASE_URL}}/connect/token \
  -u $CLIENT_ID:$CLIENT_SECRET \
  -d "grant_type=client_credentials&scope=Shop"

# → returns access_token

curl {{API_BASE_URL}}/shop/v1/discovery/events \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Accept-Language: de-DE"
Système de démo
Statut en direct
Vérification…
API…
Base de données…
Temps de réponse…
Dernière vérification: —
Utilisé & intégré par
Deutsche TelekomDeutsche MesseMesse FrankfurtMesse EssenMesse StuttgartDeutsche Landwirtschafts-Gesellschaft (DLG)NürnbergMesseMesse BremenMesse MünchenMesse Offenburg-OrtenauRX Global
Conçu pour les décideurs techniques

Six choses dont votre équipe d'intégration vous remerciera vraiment.

Pensé pour les CTO et les équipes plateforme — authentification, localisation, webhooks et idempotence, sans contournements.

OAuth 2.0 client credentials

Générez des jetons bearer à courte durée de vie avec des claims scopés comme Shop ou TERP. Rotation libre — les sessions restent actives.

AUTH

Localisé par conception

Envoyez Accept-Language et chaque champ textuel revient traduit. Les cultures se propagent au panier et au checkout.

i18n

Quicodes & liens de billets

Générez des payloads QR scannables avec un seul flag. Des catégories regex intégrées classent les scans dans votre reporting.

ACCESS

Webhooks en temps réel

30 événements sur les billets, paniers, paiements et entrées. Signés en HMAC-SHA256, réessayés avec un backoff exponentiel.

EVENTS

Idempotence, par défaut

En-têtes Idempotency-Key sur chaque écriture. Les rejeux renvoient la réponse d'origine avec l'identifiant de log d'origine.

RELIABILITY

Événements prêts pour le marketing

Diffusez conversions et entrées directement vers GA4, Meta CAPI ou votre propre entrepôt de données via webhooks.

ACTIVATION
Quickstart

En ligne en quatre étapes, payé à la cinquième.

1

Générer un token

Échangez vos client credentials contre un bearer à courte durée de vie sur /connect/token. Mettez-le en cache ~50 minutes.

2

Découvrir les événements

Récupérez le catalogue d'événements avec noms localisés, créneaux et assortiments tarifaires. Filtrez par date, lieu, slug.

3

Construire un panier

Créez un panier idempotent, ajoutez des articles par id d'article ou slug, rattachez un client, choisissez un prestataire de paiement.

4

Confirmer & délivrer

Verrouillez le panier, lancez le checkout, recevez les Quicodes + liens de billets. Un webhook se déclenche à chaque achat réussi.

curl {{API_BASE_URL}}/connect/token \
  -u $CLIENT_ID:$CLIENT_SECRET \
  -d "grant_type=client_credentials&scope=Shop"

# → returns access_token

curl {{API_BASE_URL}}/shop/v1/discovery/events \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Accept-Language: de-DE"
  1. Votre backend appelle ADITUS :
    Token
    POST /connect/token

    Client credentials en entrée, bearer à courte durée de vie en sortie. Les secrets ne quittent jamais votre backend.

  2. Votre backend appelle ADITUS :
    Découverte des événements
    GET /shop/v1/discovery/events

    Catalogue localisé des événements, créneaux et assortiments tarifaires.

  3. Votre backend appelle ADITUS :
    Panier — idempotent
    POST /shop/v1/cart

    Créez le panier, ajoutez les articles, rattachez l'acheteur. Les retries sont sûrs — même panier, pas de doublons.

  4. Votre backend appelle ADITUS :
    Checkout
    POST /shop/v1/cart/{id}/checkout

    Verrouillez le panier et payez. La réponse contient les Quicodes et les liens de billets à délivrer.

  5. ADITUS appelle votre backend (asynchrone) :
    Webhookasync
    POST https://your-backend/webhook

    Après chaque achat réussi, ADITUS appelle votre endpoint — de façon asynchrone, indépendamment de la réponse du checkout.

Le flux complet, de bout en bout — quatre appels synchrones aller, un webhook asynchrone retour.
Shop Micro Frontend

La billetterie, native sur votre site.

Un seul appel mount() intègre tout le parcours d'achat — découverte, panier, inscription, checkout — directement dans votre page : sans iframe, à vos couleurs via des design tokens, localisé et responsive d'origine.

Découvrir le Micro Frontend →
Page de l'événement Experience Days avec la billetterie intégrée affichant les catégories, les détails, les prix et le choix des quantités
Référence API

Tous les endpoints, proprement regroupés.

Du token OAuth au rejeu de webhook — 10 sections, chaque requête documentée avec exemples, en-têtes et réponses.

Introduction

Votre point de départ pour l'API ADITUS : ce que couvre la plateforme, comment les sections s'articulent et par où commencer votre intégration.

Guidelines

Les conventions de l'API : structure des requêtes et des URI, authentification Basic ou OAuth, verbes HTTP, codes de statut et format des réponses.

Just Entrance

ADITUS hardware can be used with external registration vendors. There are different ways to realise the requirements to connect external systems for a smooth visitor experience ons

Exemple : importez des billets externes, réconciliez-les automatiquement et rendez-les prêts pour l'entrée instantanément.

Ticket purchase & registration

The Shop API deals with requests concerning shop processes. This includes finding shop resources, the user and managing the cart and buying process. Discovery Uses to discover the

Exemple : un achat de billets complet dans votre app — charger l'assortiment, remplir le panier, saisir les données de l'acheteur, payer.

Byndr

Byndr is a product API designed to enable seamless, secure connections between event attendees through badge (QR code) scans. It facilitates the creation of unidirectional, recipro

Survey

A survey is an instrument for systematic data collection. It consists of a series of questions designed to collect specific information from visitors. Main topics are: - Dynamic fo

Assets

Please prefer using this API section over the deprecated theme API. The Assets API serves static content for our products, such as images, tickets and receipts, as well as theming

Dans la démo en direct, nous vous montrons entre autres comment récupérer et utiliser les assets →

Webhooks

🚀 Connect your ticket shop with your favorite apps! Imagine your ticket shop could communicate with your CRM, accounting tools, or newsletter systems in real time — no more manual

Exemple : un scan à l'entrée déclenche un webhook en temps réel — Salesforce, HubSpot & cie lancent les relances automatiquement.
Voir toutes les sections →
Live-Demo

Découvrez l'API en direct et concrètement.

La démo en direct vous fait parcourir un salon entièrement modélisé avec assortiments, billets, panier et inscription — chaque étape montre la vraie requête API et la réponse en direct, sans carte bancaire.

Ouvrir la démo en direct