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

610

Endpoints

Sections

1 Md +

REQ./AN

●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"

Système de démo

Statut en direct

Vérification en direct dans le navigateur

Le système de démo public ADITUS alimente tous les exemples interactifs de ce portail — découverte d'événements, panier, paiement et billets fonctionnent avec une véritable API Shop et une base de données en direct.

Dès que cette page se charge dans votre navigateur, la disponibilité actuelle de l'API Shop, de ses services en amont et le temps de réponse sont vérifiés en direct.

La vérification en direct démarre au chargement

Utilisé & intégré par

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

Portrait de Marc Luzoff, CEO d'ADITUS — **Marc Luzoff**CEO

Quickstart

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

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.

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.

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.

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 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"

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.
Votre backend appelle ADITUS :
Découverte des événements
GET /shop/v1/discovery/events
Catalogue localisé des événements, créneaux et assortiments tarifaires.
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.
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.
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.

Portrait de Sebastian Kluge, Head of Products chez ADITUS — **Sebastian Kluge**Head of Products

Shop Micro Frontend

La billetterie qui se fond dans votre site.

Vos visiteurs découvrent, choisissent leurs billets et finalisent leur achat sans jamais quitter votre site — le tout intégré en quelques lignes de code. Les design tokens portent votre identité de marque à chaque étape, en responsive et localisé d'origine. Résultat : une expérience de marque cohérente, plus de confiance, moins d'abandons d'achat — et une billetterie qui vend, tout simplement.

En savoir plus sur 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

Conçu pour votre stack

Intégration ouverte

Light DOM — sans iframe ni Shadow DOM
React 18 et 19
Indépendant du framework via mount(container, config)
Hooks CSS sémantiques et design tokens
Changement de langue et de culture en direct

Exploitation sécurisée

Modèle de session et d’authentification documenté
Création des jetons de session de serveur à serveur
Exigences Content Security Policy concrètes
L’architecture Payment Page réduit le périmètre PCI

Prêt pour la production

Redirections de paiement avec reprise sécurisée du parcours
Callbacks hôte et webhooks côté serveur
Événements e-commerce GA4 facultatifs
Compatible avec les hôtes SSR comme Next.js et Nuxt
Package source ou bundle versionné auto-hébergé

Portrait de Marc Ehbrecht, Team Lead Integration & Consulting chez ADITUS — **Marc Ehbrecht**Team Lead Integration & Consulting

Référence API

Tous les endpoints, proprement regroupés.

Du token OAuth au rejeu de webhook — 11 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 OAuth 2.0 (client credentials), 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 …

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

Just Entrance: cas d'usage →

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.

Ticket purchase & registration: cas d'usage →

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 …

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 …

Assets

L'API Assets fournit les contenus statiques de la plateforme : images et icônes, billets PDF et reçus, ainsi que les données de thème (logos, bannières, couleurs), par contexte.

La démo en direct montre comment récupérer et utiliser les assets.

Ouvrir la démo en direct →

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.

Webhooks: cas d'usage →

Business Intelligence

A read-only OData v4 feed that hands you your complete ticketing history as four analysis-ready datasets, built to bulk-load into your own data warehouse. Standard OData v4 over …

Exemple : votre extraction lit ventes et scans en direct dans votre entrepôt via OData v4 — dans le tableau de bord pendant le salon.

Business Intelligence: cas d'usage →

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