Saltar al contenido principal

Historial de respuestas: GET /v1/history

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

Lista las preguntas que tu tenant ya respondió con éxito por API key, de la más reciente a la más antigua, con todo lo necesario para ejecutar de nuevo el SQL. No llama al LLM, así que no gasta tokens.

Parámetros de query​

ParámetroTipoDescripción
limitenteroDe 1 a 50. Por defecto 20.
beforeenteroCursor de paginación: pasa el next_before de la página anterior.
qstringFiltra por el texto de la pregunta, sin distinguir mayúsculas y minúsculas (% y _ son literales). Hasta 200 caracteres.
curl -sS "https://app.datafala.com.br/v1/history?q=pedidos&limit=10" \
  -H "Authorization: Bearer $DATAFALA_API_KEY"

Respuesta 200​

{
  "items": [
    {
      "request_id": "req_0f3c9a7d2b6e4f1a8c5d0e9b7a6f3c21",
      "created_at": "2026-10-22T14:02:11.123Z",
      "question": "¿Cuántos pedidos se hicieron ayer?",
      "locale": "es",
      "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": "Cuenta los pedidos creados ayer.",
      "feedback_rating": "good"
    }
  ],
  "next_before": 1234
}

next_before es null en la última página. feedback_rating es good, bad o null.

Una respuesta específica: GET /v1/history/{request_id}​

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

Devuelve un único elemento con el mismo formato de arriba. Responde 404 request_not_found si el request_id no existe, es de otro tenant o no es una respuesta reutilizable.

Qué entra y qué no​

  • Solo entran las respuestas exitosas obtenidas con API key. Las preguntas rechazadas, sin respuesta, con error o hechas en el playground del panel no aparecen.
  • El historial es de todo el tenant, no del usuario final. Si necesitas separarlo por persona, guarda el request_id en tu sistema junto con el usuario.
Puntos de atención al reutilizar
  • Los params son los valores de la época. "Ayer" se resolvió el día de la pregunta; ejecutarla mañana consulta el mismo intervalo. Para preguntas que dependen de "hoy", genera de nuevo con /v1/ask o ajusta los params de tu lado.
  • El SQL guardado no se vuelve a validar. Si el schema cambió después (una tabla o columna se eliminó), la consulta puede fallar en tu base de datos. Trata un error de ejecución de una respuesta reutilizada como señal para generarla de nuevo.