O que há de novo na QAPI

A partir de hoje, a QAPI passa a adotar o modelo de créditos antecipados (pré-pago): a API só responde a requisições de contas com cotas em saldo. Não há mais cobrança pós-paga nem fatura no fim do mês — o consumo é sempre debitado de um saldo pré-carregado.

• Tarifa reduzida pela metade: de R$ 1,00 para R$ 0,50 a cada 1.000 requisições — R$ 1,00 agora equivale a 2.000 cotas.
• Recarga mínima de R$ 5,00, sempre em múltiplos de R$ 5,00 (R$ 5, R$ 10, R$ 15, R$ 20, ...). R$ 5,00 = 10.000 requisições.
• Sem cotas em saldo, todas as chamadas retornam 402 Payment Required com um corpo de erro explicando a mudança de política e como recarregar — nenhuma requisição é processada sem crédito disponível.
• Novos avisos por e-mail: quando o saldo cai abaixo de 1.000 cotas e quando o saldo chega a zero, para você nunca ser pego de surpresa.
• Faturas geradas antes de 01/08/2026, referentes ao modelo de cobrança anterior, continuam disponíveis para consulta em /payments.

A QAPI deixa de ser puramente somente-leitura: agora é possível montar simulados sob demanda, comentar em questões (dúvidas ou gabarito incorreto) e abrir chamados de suporte diretamente pela API, sem sair do seu código.

• GET /api/simulados — monta um simulado na hora a partir de filtros (banca, órgão, cargo, matéria, assunto, ano) e de size (quantidade de questões, máx. 100). Nada é salvo — a mesma chamada devolve uma seleção e ordem diferentes a cada vez.
• POST /api/comentarios e GET /api/comentarios?questao=:id — crie e liste comentários em qualquer questão. PUT e DELETE /api/comentarios/:id editam ou removem um comentário existente.
• POST /api/suporte — abre um chamado (bug na API, questão incorreta, falha de serviço etc.) informando incidente, descrição, nome e e-mail de contato. Este endpoint é intencionalmente apenas para abertura — consulta e gestão dos chamados continuam restritas à equipe QAPI, para não expor dados de um cliente a outro.
• Todos os endpoints novos requerem Q-Api-Key e são contabilizados no billing como qualquer outra requisição.

A partir desta versão, clientes da API podem consultar as provas de concurso armazenadas no sistema. Cada prova reúne metadados do exame e, quando disponível, links diretos para os PDFs da prova e do gabarito oficial.

• GET /api/provas — lista provas com paginação e filtros por banca, órgão, cargo e ano. Ordenação: mais recentes primeiro. Máximo de 100 itens por página.
• GET /api/provas/:id — retorna uma prova pelo ID, incluindo linkProva, linkGabarito e metadados de upload (nome do arquivo, tamanho, data). Retorna 404 quando não encontrada.
• Ambos os endpoints requerem autenticação via header Q-Api-Key.
• Endpoint adicionado ao Playground para testes interativos.

Usuários autenticados passaram a contar com um ambiente de testes integrado e um canal de suporte direto com a equipe.

• Playground — teste qualquer endpoint com sua API Key diretamente no navegador, veja o JSON de resposta e o tempo de execução.
• Chat de suporte em tempo real entre usuários e administradores.
• Painel administrativo de chat com histórico por conversa.

• Geração automática de faturas mensais em PDF.
• Confirmação de pagamento por comprovante PIX.
• Suspensão e reativação de API Keys pelo painel admin.
• Histórico de pagamentos disponível no dashboard do usuário.
• Logs de acesso detalhados por endpoint e API Key.

Primeira versão pública da API de questões de concursos públicos.

• Endpoint GET /api/questoes com filtros por banca, órgão, cargo, matéria, assunto e ano.
• Endpoint GET /api/textos/:codigo para recuperar textos base de questões.
• Catálogos de filtros: /bancas, /orgaos, /cargos, /materias, /assuntos.
• Autenticação via API Key com prefixo qb_.
• Dashboard de uso com gráfico diário e resumo mensal.
• Registro de conta com CPF único por usuário.