Richiedere accesso API

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
565
Endpoint
10
Sezioni
1 Mld +
RICH./ANNO
●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"
Sistema demo
Stato in tempo reale
Verifica in corso…
API…
Database…
Tempo di risposta…
Ultima verifica: —
Scelto e integrato da
Deutsche TelekomDeutsche MesseMesse FrankfurtMesse EssenMesse StuttgartDeutsche Landwirtschafts-Gesellschaft (DLG)NürnbergMesseMesse BremenMesse MünchenMesse Offenburg-OrtenauRX Global
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
Quickstart

Online in quattro passaggi, pagamento al quinto.

1

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.

2

Cerca gli eventi

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

3

Crea un carrello

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

4

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 {{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. 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.

  2. Il tuo backend chiama ADITUS:
    Ricerca degli eventi
    GET /shop/v1/discovery/events

    Catalogo localizzato di eventi, slot e assortimenti tariffari.

  3. 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.

  4. 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.

  5. 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.
Shop Micro Frontend

Il ticketshop, nativo sul tuo sito.

Una sola chiamata a mount() integra l'intero percorso d'acquisto — scoperta, carrello, registrazione, checkout — direttamente nella tua pagina: senza iframe, nel look del tuo brand tramite design token, localizzato e responsive fin da subito.

Scopri il Micro Frontend →
Pagina dell'evento Experience Days con il ticket shop integrato che mostra categorie, dettagli, prezzi e selezione delle quantità
Riferimento API

Tutti gli endpoint, raggruppati con chiarezza.

Dal token OAuth al replay dei webhook: 10 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 Basic or OAuth, 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 ons

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

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.

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

Nella demo live ti mostriamo, tra le altre cose, come recuperare e utilizzare gli asset →

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