Ticketing e marketing,
connessi in modo intelligente.

Un'unica API per la vendita di biglietti, la gestione degli accessi e l'attivazione marketing — con la chiarezza che il tuo CTO si aspetta.

Leggi il quickstart →EsempiApri in Postman

18ms

Latenza P50

99.99%

Uptime '25

610

Endpoint

Sezioni

1 Mld +

RICH./ANNO

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

Sistema demo

Stato in tempo reale

Verifica in tempo reale nel browser

Il sistema demo pubblico di ADITUS alimenta tutti gli esempi interattivi di questo portale — scoperta eventi, carrello, checkout e biglietti funzionano su una vera API Shop con database in tempo reale.

Non appena questa pagina viene caricata nel browser, la disponibilità attuale dell'API Shop, dei suoi servizi a monte e il tempo di risposta vengono verificati in tempo reale.

La verifica in tempo reale parte al caricamento

Scelto e integrato da

Pensato per chi prende decisioni tecniche

Sei aspetti che il tuo team di integrazione apprezzerà davvero.

Progettato per CTO e team di piattaforma: autenticazione, localizzazione, webhook e idempotenza senza soluzioni alternative.

Client credentials OAuth 2.0

Genera token bearer di breve durata con claim limitati a scope come Shop o TERP. Ruotali liberamente: le sessioni restano attive.

AUTH

Localizzazione nativa

Invia Accept-Language e ogni campo testuale viene restituito tradotto. Le impostazioni locali si propagano nel carrello e nel checkout.

i18n

Quicodes e link ai biglietti

Genera payload QR scansionabili con un solo flag. Le categorie regex integrate classificano le scansioni nei tuoi report.

ACCESS

Webhook in tempo reale

30 eventi per biglietti, carrelli, pagamenti e accessi. Firmati con HMAC-SHA256 e ritentati con backoff esponenziale.

EVENTS

Idempotenza predefinita

Header Idempotency-Key per ogni scrittura. Le richieste ripetute restituiscono la risposta originale con il log ID originale.

RELIABILITY

Eventi pronti per il marketing

Invia conversioni e accessi direttamente a GA4, Meta CAPI o al tuo data warehouse tramite webhook.

ACTIVATION

Ritratto di Marc Luzoff, CEO di ADITUS — **Marc Luzoff**CEO

Quickstart

Online in quattro passaggi, pagamento al quinto.

Genera un token

Scambia le tue client credentials con un token bearer di breve durata su /connect/token. Mantienilo in cache per circa 50 minuti.

Cerca gli eventi

Recupera il catalogo degli eventi con nomi localizzati, slot e assortimenti tariffari. Filtra per data, sede o slug.

Crea un carrello

Crea un carrello idempotente, aggiungi articoli tramite ID o slug, associa un cliente e scegli un provider di pagamento.

Conferma e consegna

Blocca il carrello, esegui il checkout e ricevi Quicodes e link ai biglietti. Un webhook viene attivato dopo ogni acquisto completato.

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"

Il tuo backend chiama ADITUS:
Token
POST /connect/token
Client credentials in ingresso, bearer di breve durata in uscita. I secret non lasciano mai il tuo backend.
Il tuo backend chiama ADITUS:
Ricerca degli eventi
GET /shop/v1/discovery/events
Catalogo localizzato di eventi, slot e assortimenti tariffari.
Il tuo backend chiama ADITUS:
Carrello — idempotente
POST /shop/v1/cart
Crea il carrello, aggiungi gli articoli e associa l'acquirente. I tentativi successivi sono sicuri: stesso carrello, nessun duplicato.
Il tuo backend chiama ADITUS:
Checkout
POST /shop/v1/cart/{id}/checkout
Blocca il carrello ed effettua il pagamento. La risposta contiene i Quicodes e i link ai biglietti per la consegna.
ADITUS chiama il tuo backend (in modo asincrono):
Webhookasincrono
POST https://your-backend/webhook
Dopo ogni acquisto completato, ADITUS chiama il tuo endpoint in modo asincrono, indipendentemente dalla risposta del checkout.

L'intero flusso end-to-end: quattro chiamate sincrone in uscita e un webhook asincrono di ritorno.

Ritratto di Sebastian Kluge, Head of Products di ADITUS — **Sebastian Kluge**Head of Products

Shop Micro Frontend

Il ticketshop che sembra parte del tuo sito.

I tuoi visitatori esplorano, scelgono i biglietti e completano l'acquisto senza mai lasciare il tuo sito — integrato con poche righe di codice. I design token portano il look del tuo brand in ogni passaggio, responsive e localizzato fin da subito. Il risultato: un'esperienza di brand coerente, più fiducia, meno acquisti abbandonati — e una vendita di biglietti che semplicemente funziona.

Scopri di più sul Micro Frontend →

Pagina dell'evento Experience Days con il ticket shop integrato che mostra categorie, dettagli, prezzi e selezione delle quantità

Pensato per il tuo stack

Integrazione aperta

Light DOM — senza iframe né Shadow DOM
React 18 e 19
Indipendente dal framework tramite mount(container, config)
Hook CSS semantici e design token
Cambio live di lingua e cultura

Esercizio sicuro

Modello documentato di sessione e autenticazione
Generazione server-to-server dei token di sessione
Requisiti concreti per la Content Security Policy
L’architettura Payment Page riduce l’ambito PCI

Pronto per la produzione

Redirect di pagamento con ripresa sicura del percorso
Callback dell’host e webhook lato server
Eventi e-commerce GA4 opzionali
Compatibile con host SSR come Next.js e Nuxt
Pacchetto sorgente o bundle versionato self-hosted

Ritratto di Marc Ehbrecht, Team Lead Integration & Consulting di ADITUS — **Marc Ehbrecht**Team Lead Integration & Consulting

Riferimento API

Tutti gli endpoint, raggruppati con chiarezza.

Dal token OAuth al replay dei webhook: 11 sezioni, con ogni richiesta documentata tramite esempi, header e risposte.

Introduction

Your starting point for the ADITUS API: what the platform covers, how the sections fit together, and where to begin your integration.

Guidelines

The API's conventions: request and URI structure, authentication via OAuth 2.0 (client credentials), HTTP verbs, status codes, and the shape of every response.

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 …

Esempio: importa biglietti esterni, riconciliali automaticamente e rendili subito pronti per l'accesso.

Just Entrance: caso d'uso →

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 …

Esempio: un acquisto completo di biglietti nella tua app — carica l'assortimento, riempi il carrello, acquisisci i dati dell'acquirente ed effettua il pagamento.

Ticket purchase & registration: caso d'uso →

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

The Assets API serves the platform's static content: images and icons, ticket PDFs and receipts, plus theme data such as logos, banners and colors, resolved per context.

La demo live mostra come recuperare e utilizzare gli asset.

Apri la demo live →

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 …

Esempio: una scansione all'ingresso attiva un webhook in tempo reale — Salesforce, HubSpot e altri sistemi avviano automaticamente i follow-up.

Webhooks: caso d'uso →

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 …

Esempio: la tua estrazione legge vendite e scansioni da dati in tempo reale nel tuo data warehouse via OData v4, nella dashboard mentre la fiera è in corso.

Business Intelligence: caso d'uso →

Vedi tutte le sezioni →

Live-Demo

Prova l'API live e in prima persona.

La demo live ti guida attraverso un evento fieristico completamente modellato, con assortimenti, biglietti, carrello e registrazione: ogni passaggio mostra la richiesta API reale e la risposta live, senza carta di credito.

Apri la demo live