Pular para o conteudo
↑↓ navegar · ↵ abrir Elaxi

API para desenvolvedores

Integre a Elaxi com o seu site, app ou sistema de credenciamento. Disponível para produtores do plano Pro.

Sua chave de API

  1. 1
    Gere a chave no painel Em API para desenvolvedores no painel do produtor, dê um nome e gere a chave (formato elaxi_...).
  2. 2
    Envie no header de toda requisição x-api-key: elaxi_...
Trate a chave como senha: ela dá acesso aos ingressos dos seus eventos. Use só no servidor (nunca exponha no front-end), e se vazar, gere uma nova e desative a antiga.
Página de API para desenvolvedores no painel do produtor

Endpoints

GET /api/v1/[email protected]

Lista os pedidos pagos de um comprador nos seus eventos, com códigos dos ingressos, quantidade e status.

{ "success": true, "email": "[email protected]", "count": 1,
  "tickets": [ { "orderId": "ord_...", "eventName": "...",
    "quantity": 2, "status": "paid", "ticketCodes": ["tk_..."] } ] }
POST /api/v1/validar

Confere um código de ingresso (corpo: { "code": "tk_..." }). Retorna se é válido e o status atual — para check-in em totem ou app próprio.

{ "success": true, "valid": true, "status": "active",
  "ticketId": "tk_...", "holderName": "..." }
POST /api/v1/enviar

Reenvia por email os ingressos pagos de um comprador (corpo: { "email": "...", "eventId": "opcional" }). Limite de 10 envios por minuto.

Exemplo completo

curl https://elaxi.xyz/api/v1/validar \
  -H "x-api-key: elaxi_sua_chave" \
  -H "Content-Type: application/json" \
  -d '{ "code": "tk_..." }'

Erros comuns: 401 chave inválida/desativada, 403 recurso de outro produtor, 404 ingresso/evento não encontrado e 429 limite de requisições.

Dúvidas frequentes

Preciso do plano Pro?

Sim. A geração de chaves é liberada apenas no plano Pro; cancele o plano e as chaves são desativadas.

Há limite de requisições?

Sim, limites por minuto protegem a plataforma (validação: 30/min, geração de chave: 10/min, envio: 10/min). Passou do limite, aguarde 1 minuto.

A chave enxerga eventos de outros produtores?

Nunca. Toda consulta é filtrada pelo dono da chave — ingresso de outro produtor retorna 403.