Referencia

Filas

Uma fila encadeia análises sobre vários lotes. Somente leitura aqui: enfileirar e executar consome créditos e armazenamento, e continua sendo uma ação manual dentro do Kaax.

GET/api/v2/queues

As filas salvas da conta, com seus passos.

Parámetros

pageintegeropcionaldefault 1

Página, começando em 1.

limitintegeropcionaldefault 20 · max 100

Resultados por página.

GET/api/v2/queue-runs

As execuções enfileiradas ou executadas, com o estado de cada passo.

Parámetros

statusstringopcionalpending · claimed · running · completed · failed · cancelled

Filtra pelo estado da execução.

pageintegeropcionaldefault 1

Página, começando em 1.

limitintegeropcionaldefault 20 · max 100

Resultados por página.

Resposta

json
{
  "total": 1,
  "page": 1,
  "limit": 20,
  "data": [
    {
      "id": "6a7a90ca3daa44929f42a440",
      "name": "Campaña mayo",
      "queueId": "6a7a8ca87a894f021d2224a7",
      "status": "completed",
      "estimatedHa": 18.4,
      "steps": [
        {
          "order": 1,
          "lotId": "6a7a8c177a894f021d22249e",
          "analysisType": "counting",
          "status": "completed",
          "analysisId": "675a93c456a2f093c8c4651f",
          "finishedAt": "2026-05-14T18:22:34.159Z"
        }
      ]
    }
  ]
}

A tener en cuenta

  • Este é o endpoint que se consulta para saber que uma fila terminou: o Kaax não tem notificações push.
  • O `analysisId` de um passo terminado é o que o liga ao resultado em `GET /api/v2/analyses`.