Kaax
InicioEntrar
Referencia

Plantillas de reporte

Definen cómo se ve un reporte: qué estadísticas lleva, en qué layout y con qué escala de color. Una configuración las referencia por id.

GET/api/v2/templates

Las plantillas de la cuenta.

Parámetros

analysisTypestringopcionalcounting · replanting · path

Filtra por tipo de análisis.

reportTypestringopcional

Filtra por reportType exacto.

reportCategorystringopcionalgeneral · vegetation_index

Filtra por categoría.

pageintegeropcionaldefault 1

Página, empezando en 1.

limitintegeropcionaldefault 20 · max 100

Resultados por página.

GET/api/v2/templates/presets

Plantillas de arranque, cada una con un seedPayload listo para POSTear.

A tener en cuenta

  • El camino que funciona la primera vez: tomá un preset, sobreescribí `name`, y POSTealo. Escribir `layouts` a mano es escribir coordenadas normalizadas 0..1 anidadas.
POST/api/v2/templates

Crea una plantilla. Devuelve 201 con el documento serializado.

A tener en cuenta

  • Cuenta contra el límite de plantillas del plan, compartido entre el dueño y todos los sub-usuarios.
  • Un 400 trae el detalle por campo en `issues` — leelo, dice exactamente qué se rechazó.
GET/api/v2/templates/{id}

Una plantilla por id.

PUT/api/v2/templates/{id}

Reemplaza la plantilla completa.

A tener en cuenta

  • Es un REEMPLAZO, no una fusión: mandá el documento entero. Una fusión parcial sobre `layouts` deja un layout a medias que renderiza mal.
  • `userId` en el cuerpo se ignora. La propiedad no se reasigna.
DELETE/api/v2/templates/{id}

Borra la plantilla.

POST/api/v2/templates/validate-formula

Valida una fórmula de Custom_Index contra el mismo parser que aplica el servidor, y avisa si usa L.

Parámetros

formulastringrequerido

La expresión a validar. Máximo 2000 caracteres.

Respuesta

json
{
  "valid": true,
  "usesL": true
}

A tener en cuenta

  • Validá ANTES de crear. Si no, la única señal es una plantilla rechazada, que se lee como «la plantilla está mal» y no «la fórmula está mal».
  • `usesL: true` significa que la plantilla también necesita `saviL`.