API para desenvolvedores
Integre consulta de compradores, validação de ingressos e reenvio de QRs direto na sua plataforma.
Autenticação
Todas as chamadas exigem uma chave de API no cabeçalho x-api-key. Chaves são geradas na área do produtor (Plano Pro).
GET /api/v1/[email protected]
x-api-key: elaxi_xxxxxxxxxxxxxxxxxxxxxxxx
/api/v1/consulta
Lista todos os ingressos pagos de um email.
| Email do comprador | obrigatório |
curl "https://elaxi.xyz/api/v1/[email protected]" -H "x-api-key: SUA_CHAVE"
/api/v1/validar
Consulta o status atual de um ingresso (ativo, usado, reembolsado).
| code | Código do ingresso (presente no QR Code) | obrigatório |
curl -X POST "https://elaxi.xyz/api/v1/validar" -H "x-api-key: SUA_CHAVE" -H "Content-Type: application/json" -d '{"code":"CODIGO_DO_INGRESSO"}'
/api/v1/enviar
Reenvia o QR Code dos ingressos pagos por email.
| Email do comprador | obrigatório | |
| eventId | Filtra por evento específico (opcional) | opcional |
curl -X POST "https://elaxi.xyz/api/v1/enviar" -H "x-api-key: SUA_CHAVE" -H "Content-Type: application/json" -d '{"email":"[email protected]"}'
Respostas
Todas as respostas são JSON. Erros retornam {"error": "mensagem"} com status HTTP apropriado (400, 401, 403, 404, 500).
A API está disponível apenas no Plano Pro. Gerar chave de API →
Repasse de taxas
A Elaxi retém o valor total das vendas; o produtor solicita saques via painel.
Taxas por ingresso (taxa de manutenção):
- Plano Gratuito: 10,5% (PIX ou cartão), piso R$ 3,99
- Plano Pro: 7% (PIX ou cartão), piso R$ 2,49
Taxa adicional por evento (contractual):
A Elaxi cobra 1% sobre o valor total das vendas de cada evento, liquidado após o encerramento do evento. Não é repassada ao comprador.
Para mais detalhes legais, consulte /termos.