Pular para o conteúdo principal

Histórico de respostas: GET /v1/history

GET https://app.datafala.com.br/v1/history

Lista as perguntas que o seu tenant já respondeu com sucesso por API key, da mais recente para a mais antiga, com tudo o que é preciso para executar o SQL de novo. Não chama a LLM, então não gasta tokens.

Parâmetros de query​

ParâmetroTipoDescrição
limitinteiroDe 1 a 50. Padrão 20.
beforeinteiroCursor de paginação: passe o next_before da página anterior.
qstringFiltra pelo texto da pergunta, sem diferenciar maiúsculas e minúsculas (% e _ são literais). Até 200 caracteres.
curl -sS "https://app.datafala.com.br/v1/history?q=pedidos&limit=10" \
  -H "Authorization: Bearer $DATAFALA_API_KEY"

Resposta 200​

{
  "items": [
    {
      "request_id": "req_0f3c9a7d2b6e4f1a8c5d0e9b7a6f3c21",
      "created_at": "2026-10-22T14:02:11.123Z",
      "question": "Quantos pedidos foram feitos ontem?",
      "locale": "pt-BR",
      "sql": "SELECT count(*) AS total FROM public.pedidos WHERE criado_em >= %(start)s AND criado_em < %(end)s",
      "params": { "start": "2026-10-21", "end": "2026-10-22" },
      "dialect": "postgres",
      "tables": ["public.pedidos"],
      "explanation": "Conta os pedidos criados ontem.",
      "feedback_rating": "good"
    }
  ],
  "next_before": 1234
}

next_before é null na última página. feedback_rating é good, bad ou null.

Uma resposta específica: GET /v1/history/{request_id}​

GET https://app.datafala.com.br/v1/history/req_0f3c9a7d2b6e4f1a8c5d0e9b7a6f3c21

Devolve um único item no mesmo formato acima. Responde 404 request_not_found se o request_id não existir, for de outro tenant ou não for uma resposta reaproveitável.

O que entra e o que não entra​

  • Entram só respostas bem-sucedidas obtidas com API key. Perguntas rejeitadas, sem resposta, com erro ou feitas no playground do painel não aparecem.
  • O histórico é do tenant inteiro, não do usuário final. Se precisar separar por pessoa, guarde o request_id no seu sistema junto com o usuário.
Pontos de atenção ao reaproveitar
  • Os params são os valores da época. "Ontem" foi resolvido no dia da pergunta; reexecutar amanhã consulta o mesmo intervalo. Para perguntas que dependem de "hoje", gere de novo com /v1/ask ou ajuste os params do seu lado.
  • O SQL guardado não é revalidado. Se o schema mudou depois (tabela ou coluna removida), a consulta pode falhar no seu banco. Trate erro de execução de uma resposta reaproveitada como sinal para gerar de novo.