A marca de dados do PIRANOTDados públicos do Brasil, com a fonte oficial
DataX por PIRANOT
Entrar

Docs

Qualidade
e erratas.

Como o dado é verificado antes de ficar público, o que o campo qualidade informa e como reportar um erro.

Pipeline

Staging
Toda coleta grava primeiro numa área de preparação, nunca por cima do dado publicado.
Checks
Validação de formato e tipo, identidade e unidade da variável, continuidade do período, data de coleta não futura, totais conferidos com a fonte ou com o site quando existe referência.
Promoção
Só o corte que passa é promovido; o fingerprint muda apenas quando o dado muda.
Quarentena
Falha em qualquer check mantém a última versão boa no ar, com status "stale" e a data de coleta original. Nunca zero no lugar de dado ausente.
Recheque noturno
Todo dia às 02h (timer no servidor), 5 registros por dataset são pedidos de novo à fonte oficial: séries do BCB (até 15 requisições), crédito imobiliário (até 20) e loterias (até 50, com 2ª fonte no banco do site do PIRANOT), com pelo menos 5 s entre requisições. Divergência confirmada corrige o dado e entra em /erratas.

O resumo qualidade

Toda resposta da API v1 e do MCP traz, além de last_updated, fonte, source_url e ressalvas, o resumo qualidade do dataset: status (ok, ou divergente quando algum item está retido ou em verificação), verificado_em (data do último ciclo de checks) e checks_ok (quantos checks o dado servido passou). O mesmo resumo, por dataset e sem chave, está em /status.json, que também traz o selo de atualização e a data de cada dado.

Reportar um erro

curl -X POST https://www.piranot.com.br/datax/api/v1/qualidade/reportar \
  -H "X-Api-Key: SUA_CHAVE" -H "Content-Type: application/json" \
  -d '{"dataset":"loterias-caixa","chave_registro":"megasena:3075","valor_visto":"07 10 14 27 36 55","valor_esperado":"07 10 14 27 36 56","fonte_esperada":"https://loterias.caixa.gov.br/"}'

Corpo: dataset (id do catálogo), chave_registro (identificador do item: concurso, data da observação ou seção), valor_visto (o que o DataX mostrou), valor_esperado (o que você viu na fonte) e fonte_esperada (URL oficial). A resposta devolve o id do reporte, o estado, o valor_oficial lido na fonte e uma nota. O reporte dispara um único recheque direcionado na fonte oficial; reporte repetido de item já em verificação não gera segunda consulta.

em-verificacao
Recebido e aguardando o recheque (fonte oficial consultada uma vez).
procedente
A fonte confirmou o erro: o dado foi corrigido com o valor oficial e a correção entrou em /erratas, com item, valor errado, valor corrigido, motivo e quem reportou.
improcedente
A fonte oficial confere com o DataX; a resposta traz o valor oficial.
sem-confirmacao
A fonte não respondeu, não tem o ponto, ou o valor oficial reprovou nos checks e ficou em quarentena para conferência humana.

Nada se corrige em silêncio: toda correção aparece em /erratas. Reportes da redação do PIRANOT (Nexus) seguem o mesmo endpoint. Sem chave de API, escreva para [email protected] com o mesmo conteúdo.

Aviso. O DataX PIRANOT organiza dados de fontes oficiais e pode conter erros ou atrasos. Confira na fonte oficial, indicada em cada dado, antes de qualquer decisão importante. Respostas geradas por IA podem errar.DataX PIRANOT organises data from official sources and may contain errors or delays. Check the official source, linked with each dataset, before any important decision. AI-generated answers can be wrong.