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
610
Endpoints
11
Secções
1B+
PED./ANO
●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 de demonstração
Estado em direto
Verificação em direto no navegador

O sistema de demonstração público da ADITUS alimenta todos os exemplos interativos deste portal — a descoberta de eventos, o carrinho, o checkout e os bilhetes funcionam com uma verdadeira API Shop e uma base de dados em direto.

Assim que esta página carrega no navegador, a disponibilidade atual da API Shop, dos seus serviços a montante e o tempo de resposta são verificados em direto.

A verificação em direto inicia ao carregar
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

Passei a maior parte da minha vida profissional a desenvolver software. Este portal é o que, na altura, teria desejado de qualquer fornecedor.

Retrato de Marc Luzoff, CEO da ADITUSMarc LuzoffCEO
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 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"
  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.

Uma API é um produto e a documentação é a sua interface de utilizador. Ela decide se pessoas e agentes de IA conseguem criar valor com ela. A medida é o que os outros alcançam com a nossa API sem depender do nosso conhecimento interno. Sem uma documentação muito boa publicamos, no máximo, um artefacto, mas não um produto.

Retrato de Sebastian Kluge, Head of Products na ADITUSSebastian KlugeHead of Products
Shop Micro Frontend

A loja de bilhetes que parece o seu site.

Os seus visitantes exploram, escolhem os bilhetes e concluem a compra sem nunca sair do seu site — integrado com apenas algumas linhas de código. Os design tokens levam a sua imagem de marca a cada passo, responsivo e localizado de origem. O resultado: uma experiência de marca consistente, mais confiança, menos compras abandonadas — e uma venda de bilhetes que simplesmente funciona.

Mais sobre o Micro Frontend →
Página do evento Experience Days com a loja integrada a mostrar categorias, detalhes, preços e seleção de quantidades

Criado para a sua stack

Integração aberta

  • Light DOM — sem iframe nem Shadow DOM
  • React 18 e 19
  • Independente de framework via mount(container, config)
  • Hooks CSS semânticos e design tokens
  • Mudança de idioma e cultura em direto

Operação segura

  • Modelo documentado de sessão e autenticação
  • Criação server-to-server de tokens de sessão
  • Requisitos concretos de Content Security Policy
  • A arquitetura Payment Page reduz o âmbito PCI

Pronto para produção

  • Redirecionamentos de pagamento com retoma segura do percurso
  • Callbacks do host e webhooks do servidor
  • Eventos de comércio eletrónico GA4 opcionais
  • Compatível com hosts SSR como Next.js e Nuxt
  • Pacote fonte ou bundle versionado autoalojado

A maioria dos projetos de integração não perde tempo com o código, mas sim a fazer as perguntas certas. O Micro Frontend responde desde o início à mais importante: a loja corre no teu ambiente, com o teu look, sem que abdiques do controlo sobre a tua própria página. O Styling Tool e o Integration Tester ajudam-te a ver isso rapidamente.

Retrato de Marc Ehbrecht, Team Lead Integration & Consulting na ADITUSMarc EhbrechtTeam Lead Integration & Consulting
Referência da API

Todos os endpoints, organizados com clareza.

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

Introduction

Introduction

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

Guidelines

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

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 …

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

Just Entrance: caso de utilização →
Ticket purchase & registration

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.

Ticket purchase & registration: caso de utilização →
Byndr

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

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

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.

A demonstração em direto mostra como obter e utilizar os recursos.

Abrir a demonstração em direto →
Webhooks

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.

Webhooks: caso de utilização →
Business Intelligence

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 …

Exemplo: o seu extrato lê vendas e leituras a partir de dados em direto para o seu data warehouse via OData v4 — no dashboard enquanto a feira decorre.

Business Intelligence: caso de utilização →
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