Documentação da API
A API REST da Burifa já está disponível em beta para leitura das suas rifas. Gere um token no painel e comece a integrar. Endpoints de escrita (criar, ativar e sortear) chegam nas próximas versões.
O que a API oferece
Leitura de rifas
Liste e detalhe suas rifas, com contadores de venda. Disponível agora.
Números vendidos
Consulte os tickets pagos de cada rifa, paginados. Disponível agora.
Autenticação por token
Bearer Token gerado pelo painel, revogável a qualquer momento.
Escrita e webhooks
Criar/ativar/sortear rifas e eventos em tempo real, em breve.
Convenções da API
Base URL: https://api.burifa.com/v1
Versionamento: via path (/v1/...). Mudanças breaking nascem em uma nova major version.
Formato: JSON em request e response. Datas em ISO 8601. Valores monetários em centavos.
Erros: HTTP status semântico (400 validação, 401 auth, 403 permissão, 404 recurso, 429 rate limit, 500 servidor) + corpo JSON com code, message e details.