Visão Geral
A API de Quiz fornece endpoints para o sistema de recuperação de streaks do The News. Os quizzes são gerados automaticamente a partir das edições diárias (matinal e noturna/NIGHT) da newsletter, permitindo que usuários recuperem seus streaks perdidos respondendo perguntas sobre o conteúdo.Base URL
Autenticação
A maioria dos endpoints requer autenticação via JWT token. Endpoints administrativos estão separados e claramente indicados.Headers Obrigatórios
Recursos Principais
1. Quizzes para Usuários
- Listar quizzes disponíveis (últimos 3 dias)
- Visualizar perguntas do quiz
- Submeter respostas
- Histórico de tentativas
- Recuperação automática de streak
2. Administração
- Gerar quiz diário manualmente
- Criar quiz para data específica
- Listar todos os quizzes
- Deletar quizzes
Regras do Sistema
Endpoints Disponíveis
Rotas Autenticadas (Usuário)
Rotas Administrativas
Fluxo de Recuperação de Streak
Quando o usuário passa no quiz (acertos >= 6):- Sistema verifica as respostas do usuário
- Calcula pontuação total
- Se passou, registra leitura histórica automaticamente
- Streak é recuperado para a data do quiz
- Tentativa é salva com
streakRecovered: true
Tratamento de Erros
A API retorna erros padronizados no seguinte formato:Códigos de Status HTTP
Geração Automática de Quizzes
O sistema gera quizzes automaticamente todos os dias às 7h UTC usando:- Beehiiv API: Busca a edição do dia anterior (matinal e noturna)
- OpenAI GPT-4o: Gera 10 perguntas sobre o conteúdo de cada edição
- Cloudflare D1: Armazena quizzes e tentativas
Edições Suportadas
Cada dia pode gerar dois quizzes: um para a edição matinal e outro para a edição noturna (NIGHT).
Suporte
Para dúvidas ou problemas com a API, entre em contato:- Email: tech@waffle.com.br