Endpoints

Endpoint:
/Changelog

Histórico de alterações da API Flair. Acompanhe novos endpoints, breaking changes e melhorias.

Última AtualizaçãoMAR 2026
GETv1.4.0 — Março 2026

Benefits API

Novo sistema de vantagens por tipo de ingresso. Organizadores podem definir benefícios (Open Bar, Entrada VIP, Meet & Greet) e exibi-los na tabela comparativa da página pública.

Novos endpoints:

  PUT  /ticket-types/:id/benefits
  GET  /ticket-types/:id/benefits
  GET  /public/events/:id/benefits

Novo modelo:
  ticket_type_benefits (
    id, tenant_id, ticket_type_id,
    name, sort_order, created_at
  )
Resposta
NOVO
Impacto:
  → Sem breaking changes
  → Novo campo na resposta de ticket-types
  → Página pública do evento mostra tabela
    comparativa automaticamente
GETv1.3.0 — Março 2026

Spatial Mapping & Multi-step Event Creation

Fluxo de criação de eventos em 4 etapas (Identidade → Ingressos → Mapeamento → Publicação). Editor SVG interativo para mapeamento espacial de zonas e assentos.

Mudanças:

  → Criação de evento agora é multi-step
  → Step 2: Ticket types + Batches + Benefits
  → Step 3: Editor SVG para zonas/assentos
  → Step 4: Cupons + Financeiro + Publicação
  → Evento só é criado na API ao publicar
Resposta
FEATURE
Impacto:
  → Sem breaking changes na API
  → Mudança apenas no frontend
  → Novos campos opcionais nos ticket types
GETv1.2.0 — Março 2026

Public Event Pages & Checkout Flow

Páginas públicas de eventos com dados dinâmicos da API. Fluxo completo de checkout integrado com o backend: seleção de ingressos → dados pessoais → pagamento → confirmação.

Endpoints envolvidos:

  GET  /public/events/:id
  GET  /public/events/:id/ticket-types
  POST /public/purchase
  GET  /public/purchase/:id/status
  GET  /public/purchase/:id/tickets
Resposta
FEATURE
Impacto:
  → Novas páginas: /evento/[id], /checkout,
    /confirmado, /meus-ingressos
  → Fluxo OTP para autenticação de compradores
  → Timer de 10 min no checkout
GETv1.1.0 — Março 2026

Dashboard Admin & Event Management

Painel administrativo para organizadores com métricas, vendas, gestão de eventos e configurações. Integrado com todos os endpoints protegidos da API.

Novas páginas:

  /painel          → Métricas e atividade
  /eventos         → Lista de eventos
  /eventos/[id]    → Gestão do evento
  /vendas          → Transações e receita
  /configuracoes   → Perfil, API Keys, Webhooks
Resposta
FEATURE
Hooks integrados:
  → useDashboard (GET /dashboard/*)
  → useTickets (GET /events, CRUD)
  → useSales (GET /sales/*)
  → useProfile (GET /profile)
  → useSettings (webhooks, API keys)
GETv1.0.0 — Fevereiro 2026

Lançamento Inicial

Primeira versão da API Flair com autenticação JWT, CRUD de eventos, tipos de ingresso, lotes, cupons, compras via PIX/Cartão, webhooks e sistema de assentos.

Módulos disponíveis:

  Auth         → JWT + API Keys + OTP
  Events       → CRUD completo
  Ticket Types → TICKET, PRODUCT, ADDON
  Batches      → Escalonamento automático
  Coupons      → Percentual + Valor fixo
  Purchase     → PIX (R$1,99) + Cartão (5%)
  Tickets      → Validação QR + Check-in
  Webhooks     → HMAC-SHA256 + Retries
  Sectors      → GA + Assentos numerados
  Billing      → Payouts automáticos via PIX
Resposta
RELEASE
Infraestrutura:
  → Go + Gin + GORM + PostgreSQL
  → Redis para locks de assento
  → JWT RSA-256 com rotação de chaves
  → CSRF single-use tokens
  → Rate limiting por IP e tenant
  → Idempotency keys (24h TTL)
  → Webhook retries com backoff exponencial

Pronto para escalar?

Nossa infraestrutura global processa milhões de requisições simultâneas em horários de pico. Junte-se a +500 promotores usando Flair.

99.9%

Uptime Garantido

API
terminalAPI Sandbox
api.flair.api.br
Flair