Pedir acesso à API

Bilhética e marketing,
ligados de forma inteligente.

Uma API para venda de bilhetes, gestão de entradas e ativação de marketing — com a clareza que o seu CTO espera.

Leia o guia de início rápido →ExemplosAbrir no Postman
18ms
Latência P50
99.99%
Tempo de atividade '25
565
Endpoints
10
Secções
1B+
PED./ANO
●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 de demonstração
Estado em direto
Verificando…
API…
Base de dados…
Tempo de resposta…
Última verificação: —
Com a confiança e integração de
Deutsche TelekomDeutsche MesseMesse FrankfurtMesse EssenMesse StuttgartDeutsche Landwirtschafts-Gesellschaft (DLG)NürnbergMesseMesse BremenMesse MünchenMesse Offenburg-OrtenauRX Global
Construído para decisores técnicos

Seis aspetos que a sua equipa de integração vai valorizar.

Concebido para CTOs e equipas de plataforma — autenticação, localização, webhooks e idempotência sem soluções alternativas.

Credenciais do cliente OAuth 2.0

Crie tokens bearer de curta duração com âmbitos como Shop ou TERP. Faça a rotação livremente — as sessões permanecem ativas.

AUTH

Localização de raiz

Envie Accept-Language e todos os campos de texto serão devolvidos traduzidos. As definições regionais propagam-se pelo carrinho e pelo checkout.

i18n

Quicodes e ligações para bilhetes

Gere conteúdos QR digitalizáveis com um único sinalizador. As categorias de expressões regulares integradas classificam as leituras nos seus relatórios.

ACCESS

Webhooks em tempo real

30 eventos relativos a bilhetes, carrinhos, pagamentos e acessos. Assinados com HMAC-SHA256 e repetidos com espera exponencial.

EVENTS

Idempotência, por defeito

Cabeçalhos Idempotency-Key em cada gravação. As repetições devolvem a resposta original com o ID de registo original.

RELIABILITY

Eventos preparados para marketing

Envie conversões e acessos diretamente para o GA4, a Meta CAPI ou o seu próprio armazém de dados através de webhooks.

ACTIVATION
Quickstart

Em direto em quatro passos, pago no quinto.

1

Criar um token

Troque as suas credenciais de cliente por um token bearer de curta duração em /connect/token. Guarde-o em cache durante cerca de 50 minutos.

2

Descubra eventos

Obtenha o catálogo de eventos com nomes localizados, horários e gamas de preços. Filtre por data, local ou slug.

3

Criar um carrinho

Crie um carrinho idempotente, adicione artigos pelo respetivo ID ou slug, associe um cliente e escolha um prestador de pagamentos.

4

Confirmar e entregar

Bloqueie o carrinho, execute o checkout e receba Quicodes e ligações para os bilhetes. É acionado um webhook após cada compra concluída com êxito.

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. O seu backend chama a ADITUS:
    Token
    POST /connect/token

    Credenciais de cliente à entrada, token bearer de curta duração à saída. Os segredos nunca saem do seu backend.

  2. O seu backend chama a ADITUS:
    Pesquisa de eventos
    GET /shop/v1/discovery/events

    Catálogo localizado de eventos, horários e sortidos de preços.

  3. O seu backend chama a ADITUS:
    Carrinho — idempotente
    POST /shop/v1/cart

    Cria o carrinho, adiciona artigos e associa o comprador. É seguro repetir: o mesmo carrinho, sem duplicados.

  4. O seu backend chama a ADITUS:
    Pagamento
    POST /shop/v1/cart/{id}/checkout

    Bloqueia o carrinho e efetua o pagamento. A resposta inclui os Quicodes e as ligações para entrega dos bilhetes.

  5. A ADITUS chama o seu backend (de forma assíncrona):
    Webhookassíncrono
    POST https://your-backend/webhook

    Após cada compra concluída com êxito, a ADITUS chama o seu endpoint de forma assíncrona, independentemente da resposta do checkout.

Todo o fluxo, de ponta a ponta — quatro chamadas síncronas de ida e um webhook assíncrono de retorno.
Shop Micro Frontend

A loja de bilhetes, nativa no seu site.

Uma única chamada a mount() incorpora todo o percurso de compra — descoberta, carrinho, registo, checkout — diretamente na sua página: sem iframe, com a sua imagem de marca através de design tokens, localizado e responsivo de origem.

Descobrir o Micro Frontend →
Página do evento Experience Days com a loja integrada a mostrar categorias, detalhes, preços e seleção de quantidades
Referência da API

Todos os endpoints, organizados com clareza.

Do token OAuth à repetição de webhooks — 10 secções, com todos os pedidos documentados através de exemplos, cabeçalhos e respostas.

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

Exemplo: importe bilhetes externos, reconcilie-os automaticamente e deixe-os imediatamente prontos para o acesso.

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

Exemplo: uma compra completa de bilhetes na sua aplicação — carregar a gama, preencher o carrinho, recolher os dados do comprador e pagar.

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

Na demonstração em direto mostramos, entre outras coisas, como obter e utilizar os recursos →

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

Exemplo: uma leitura à entrada aciona um webhook em tempo real — o Salesforce, o HubSpot e outros sistemas iniciam automaticamente o acompanhamento.
Ver todas as secções →
Live-Demo

Experimente a API em direto e na prática.

A demonstração em direto guia-o por um evento de feira integralmente modelado, com artigos, bilhetes, carrinho e registo — cada passo apresenta o pedido real à API e a respetiva resposta, sem necessidade de cartão.

Abrir a demonstração em direto