Kaax
InicioEntrar
Referencia

Análisis

Los resultados ya procesados: conteo, resiembra y segmentación, con sus métricas de área y densidad. Es lo que una integración consume para reportar.

GET/api/v2/analyses

Los análisis de la cuenta, filtrables y paginados.

Parámetros

namestringopcional

Nombre del lote. Coincidencia parcial, sin distinguir mayúsculas.

tagstringopcional

Etiqueta del lote — útil para separar fincas o campañas.

typestringopcionalcounting · replanting · path

Tipo de análisis.

startstringopcional

Inicio del rango: fecha ISO (2026-03-01), año suelto (2026) o milisegundos Unix.

endstringopcional

Fin del rango, en los mismos formatos que start.

pageintegeropcionaldefault 1

Página, empezando en 1.

limitintegeropcionaldefault 20 · max 100

Resultados por página.

Respuesta

json
{
  "total": 42,
  "page": 1,
  "limit": 20,
  "data": [
    {
      "_id": "675a93c456a2f093c8c4651f",
      "imageSetId": "64fa12b3e4c1a20012d3ef01",
      "name": "Banano Álamos",
      "analysisType": "counting",
      "analysis": {
        "totalAreaHa": 6.279,
        "totalCounts": 12480,
        "density": 1987.4
      },
      "kml": "<kml>…</kml>",
      "createdAt": "2026-05-14T18:22:34.159Z"
    }
  ]
}

A tener en cuenta

  • Los filtros se INTERSECAN. `name=alfa&type=replanting` devuelve solo lo que cumple ambos.
  • Ordenado por `createdAt` descendente, así que paginar es estable.
  • La apiKey de un sub-usuario ve solo los análisis de los lotes que creó y de los campos que tiene asignados, lo mismo que su dashboard. La del dueño ve toda la cuenta.
  • Reemplaza a `POST /api/v0/analyses`, que sigue funcionando pero está deprecado.
GET/api/v2/analyses/{id}

Un análisis por su id, completo y con la misma forma que un elemento de la lista.

Parámetros

idstringrequeridopath

El `_id` del análisis, tal como sale en la lista.

Respuesta

json
{
  "_id": "675a93c456a2f093c8c4651f",
  "imageSetId": "64fa12b3e4c1a20012d3ef01",
  "name": "Banano Álamos",
  "analysisType": "counting",
  "analysis": {
    "totalAreaHa": 6.279,
    "totalCounts": 12480,
    "density": 1987.4
  },
  "vegetationIndices": [
    { "indexType": "ndvi", "status": "generated", "globalMedian": 0.62 }
  ],
  "kml": "<kml>…</kml>",
  "createdAt": "2026-05-14T18:22:34.159Z"
}

A tener en cuenta

  • Si ya tenés el id, usá este endpoint en vez de recorrer la lista: no depende de en qué página haya quedado el análisis.
  • Un id que no existe, o que la apiKey no puede ver, responde 404 `ANALYSIS_NOT_FOUND`. Nunca 403: la respuesta no revela si existe en otra cuenta.
  • Un id mal formado responde 400 `INVALID_ID`.