← Volver al inicio

IRRICROPS API

Documentación Completa de Rutas - Versión 2.0.0

API para gestión agrícola, monitoreo de sensores IoT, control de riego y datos meteorológicos

Índice de Controllers

LEM Original

Controller: LEM Original

Descripción: Sistema de monitoreo agrícola y control de riego

Estado: PRODUCCIÓN

Autenticación: Requerida (usuario/password)

GET/lem

Descripción: Datos generales del sistema LEM

ParámetroTipoObligatorioDefaultDescripción
userstring-Usuario LEM
passstring-Contraseña LEM

GET/lem/equipos

Descripción: Lista de equipos LEM

ParámetroTipoObligatorioDefaultDescripción
userstring-Usuario LEM
passstring-Contraseña LEM

GET/lem/et

Descripción: Datos de evapotranspiración

ParámetroTipoObligatorioDefaultDescripción
userstring-Usuario LEM
passstring-Contraseña LEM

GET/lem/pozos

Descripción: Datos de pozos

ParámetroTipoObligatorioDefaultDescripción
userstring-Usuario LEM
passstring-Contraseña LEM

GET/lem/riego/equipo

Descripción: Datos de riego por equipo (JSON)

ParámetroTipoObligatorioDefaultDescripción
userstring-Usuario LEM
passstring-Contraseña LEM
equipostring-ID del equipo
nodosstringNo-IDs de nodos separados por coma

GET/lem/riego/equipo/csv

Descripción: Datos de riego por equipo (CSV)

ParámetroTipoObligatorioDefaultDescripción
userstring-Usuario LEM
passstring-Contraseña LEM
equipostring-ID del equipo
nodosstringNo-IDs de nodos separados por coma

LEM Refactorizado

Controller: LEM Refactorizado

Descripción: Sistema LEM con arquitectura modular

Estado: TESTING

Compatibilidad: 100% con versión original

GET/lemv2

Descripción: Obtener datos generales LEM v2

ParámetroTipoObligatorioDefaultDescripción
userstringUsuario LEM
passstringContraseña LEM
nodosstringNo-IDs de nodos separados por coma (ej: 123,456)

GET/lemv2/equipos

Descripción: Obtener lista de equipos LEM v2

ParámetroTipoObligatorioDefaultDescripción
userstringUsuario LEM
passstringContraseña LEM

GET/lemv2/et

Descripción: Obtener datos de evapotranspiración LEM v2

ParámetroTipoObligatorioDefaultDescripción
userstringUsuario LEM
passstringContraseña LEM

GET/lemv2/pozos

Descripción: Obtener datos de pozos LEM v2

ParámetroTipoObligatorioDefaultDescripción
userstringUsuario LEM
passstringContraseña LEM

GET/lemv2/riego/equipo

Descripción: Obtener datos de riego por equipo LEM v2 (JSON)

ParámetroTipoObligatorioDefaultDescripción
userstringUsuario LEM
passstringContraseña LEM
equipostring-ID del equipo
nodosstringNo-IDs de nodos separados por coma

GET/lemv2/riego/equipo/csv

Descripción: Obtener datos de riego por equipo LEM v2 (CSV)

ParámetroTipoObligatorioDefaultDescripción
userstringUsuario LEM
passstringContraseña LEM
equipostring-ID del equipo
nodosstringNo-IDs de nodos separados por coma

AA (Alejandro Acevedo)

Controller: Alejandro Acevedo - RiegoPro

Descripción: Sensores RiegoPro

GET/aa/data

Descripción: Obtener datos de sensores Alejandro Acevedo - RiegoPro

ParámetroTipoObligatorioDefaultDescripción
namestring-Identificador del cliente (ej: bouchon)
startstring-Fecha inicio (formato fecha válido)
endstring-Fecha fin (formato fecha válido)
idstring-ID del datalogger (ej: eui-24e124454c143685)
Ejemplo:
https://tools.irricrops.com/aa/data?name=bouchon&start=2025-01-01&end=2025-01-31&id=eui-24e124454c143685

GET/aa/dataloggers

Descripción: Obtener lista de dataloggers disponibles

ParámetroTipoObligatorioDefaultDescripción
namestringIdentificador del cliente (ej: bouchon)
Ejemplo:
https://tools.irricrops.com/aa/dataloggers?name=bouchon

Agrosense

Controller: Agrosense

Descripción: Red de sensores agrícolas

GET/agrosense

Descripción: Obtener datos de sensores Agrosense

ParámetroTipoObligatorioDefaultDescripción
userstring-Usuario Agrosense
passstring-Contraseña Agrosense
Ejemplo:
https://tools.irricrops.com/agrosense?user=USERNAME&pass=PASSWORD

AS (Agrosuccess)

Controller: Agrosuccess

Descripción: Sensores agrícolas Agrosuccess

GET/as

Descripción: Obtener datos de sensores Agrosuccess

ParámetroTipoObligatorioDefaultDescripción
userstring-Usuario Agrosuccess
passstring-Contraseña Agrosuccess
startstring-Fecha inicio (YYYY-MM-DD)
endstring-Fecha fin (YYYY-MM-DD)
Ejemplo:
https://tools.irricrops.com/as?user=USERNAME&pass=PASSWORD&start=2025-01-01&end=2025-01-31

Ecowitt

Controller: Ecowitt

Descripción: Estaciones meteorológicas Ecowitt

GET/ecowitt/list

Descripción: Obtener lista de estaciones Ecowitt disponibles

ParámetroTipoObligatorioDefaultDescripción
application_keystringNovalor por defectoApplication key de Ecowitt
api_keystringNovalor por defectoAPI key de Ecowitt
Ejemplo:
https://tools.irricrops.com/ecowitt/list?application_key=YOUR_APP_KEY&api_key=YOUR_API_KEY

GET/ecowitt/history

Descripción: Obtener historial de datos Ecowitt

ParámetroTipoObligatorioDefaultDescripción
application_keystringNovalor por defectoApplication key de Ecowitt
api_keystringNovalor por defectoAPI key de Ecowitt
macstringNo48:3F:DA:89:C0:64MAC address del dispositivo
startstringNo2025-01-01Fecha inicio (YYYY-MM-DD o YYYY-MM-DD HH:mm:ss)
endstringNo2025-01-01Fecha fin (YYYY-MM-DD o YYYY-MM-DD HH:mm:ss)
Ejemplo:
https://tools.irricrops.com/ecowitt/history?api_key=YOUR_KEY&mac=48:3F:DA:89:C0:64&start=2025-01-01&end=2025-01-31

GET/ecowitt/realtime

Descripción: Obtener datos en tiempo real de Ecowitt

ParámetroTipoObligatorioDefaultDescripción
application_keystringNovalor por defectoApplication key de Ecowitt
api_keystringNovalor por defectoAPI key de Ecowitt
macstringNo48:3F:DA:89:C0:64MAC address del dispositivo
Ejemplo:
https://tools.irricrops.com/ecowitt/realtime?api_key=YOUR_KEY&mac=48:3F:DA:89:C0:64

HOBO (Original)

Controller: HOBO Original

Descripción: Dataloggers HOBO versión original

GET/hobo

Descripción: Obtener datos de sensores HOBO (versión original). Filtra automáticamente por Rain, Temperature y Reference ET

ParámetroTipoObligatorioDefaultDescripción
userstring-Usuario HOBO Link (client_id)
passstring-Contraseña HOBO Link (client_secret)
useridnumber-ID de usuario HOBO Link
loggersstring-IDs de loggers separados por coma
startstringNoinicio del día actualFecha inicio (YYYY-MM-DD HH:mm:ss)
endstringNofin del día actualFecha fin (YYYY-MM-DD HH:mm:ss)
Ejemplo:
https://tools.irricrops.com/hobo?user=USERNAME&pass=PASSWORD&userid=1961&loggers=10064008,21181047&start=2025-01-01 00:00:00&end=2025-01-31 23:59:59

HOBO V2 (LI-COR Cloud)

Controller: HoboV2

Descripción: Dataloggers LI-COR Cloud - Nueva API

GET/hobov2/data

Descripción: Obtener datos de dispositivos LI-COR Cloud. Devuelve todas las mediciones disponibles sin filtrar por tipo. Calcula ET0 usando DOS métodos: Hargreaves (siempre disponible, requiere solo temperatura máx/mín) y Penman-Monteith FAO-56 (disponible si hay sensores de RH, radiación solar y viento).

ParámetroTipoObligatorioDefaultDescripción
tokenstring-Token de API de LI-COR Cloud
deviceSerialNumberstring-Número de serie del dispositivo (también acepta device_serial_number)
startstringNoinicio del día actualFecha inicio (YYYY-MM-DD, YYYY-MM-DD HH:mm:ss, ISO 8601, o epoch time)
endstringNofin del día actualFecha fin (YYYY-MM-DD, YYYY-MM-DD HH:mm:ss, ISO 8601, o epoch time)
latnumberNo35Latitud para cálculos de ET0
sensor_snstringNo-Serial numbers de sensores separados por coma (ej: "20647788-1,20647788-2"). Si se proporciona, solo se usan estos sensores para los cálculos de ET. Si no se proporciona, se usan todos los sensores disponibles.
novaluesstringNo-Si es 'true' o '1', el array 'values' será vacío [] en lugar de contener los datos. Útil para pruebas y ver estructura de datos sin procesar grandes volúmenes.
debugstringNo-Si es 'true' o '1', incluye datos crudos de la API en la respuesta
Ejemplo:
https://tools.irricrops.com/hobov2/data?token=YOUR_TOKEN&deviceSerialNumber=10851081&start=2025-11-01&end=2025-11-10
https://tools.irricrops.com/hobov2/data?token=YOUR_TOKEN&deviceSerialNumber=10851081&start=2025-11-01&end=2025-11-10&lat=-33.5&debug=true
https://tools.irricrops.com/hobov2/data?token=YOUR_TOKEN&deviceSerialNumber=10851081&start=2025-11-01&end=2025-11-10&sensor_sn=20647788-1,20647788-2
https://tools.irricrops.com/hobov2/data?token=YOUR_TOKEN&deviceSerialNumber=10851081&start=2025-11-01&end=2025-11-10&novalues=true
https://tools.irricrops.com/hobov2/data?token=YOUR_TOKEN&device_serial_number=10851081&start=2025-11-01&end=2025-11-10
Respuesta:

La respuesta incluye un array data con todos los sensores. Los sensores de temperatura incluyen un objeto et con:

  • hargreaves: Cálculo ET usando método Hargreaves (siempre disponible)
  • penman_monteith: Cálculo ET usando método Penman-Monteith FAO-56 (disponible si hay sensores de RH, radiación solar y viento)
  • sensors_used: Indica qué sensores se usaron para cada cálculo
  • missing_sensors: Array con sensores faltantes para Penman-Monteith (o null si todos están disponibles)

Si faltan sensores para Penman-Monteith, penman_monteith.daily_et y penman_monteith.summary serán null.

GET/hobov2/devices

Descripción: Obtener lista de dispositivos LI-COR Cloud

ParámetroTipoObligatorioDefaultDescripción
tokenstring-Token de API de LI-COR Cloud
debugstringNo-Si es 'true' o '1', incluye datos crudos de la API en la respuesta
Ejemplo:
https://tools.irricrops.com/hobov2/devices?token=YOUR_TOKEN
https://tools.irricrops.com/hobov2/devices?token=YOUR_TOKEN&debug=true

PLAS (Sentinel-Hub)

Controller: PLAS

Descripción: Servicios de mapeo Sentinel-Hub

GET/plas

Descripción: Información general del servicio PLAS y endpoints disponibles

Parámetros: Ninguno

GET/plas/key

Descripción: Obtener clave API de PLAS

Parámetros: Ninguno

GET/plas/map

Descripción: Obtener mapa/tile de Sentinel-Hub

ParámetroTipoObligatorioDefaultDescripción
BBOXstring-Bounding box del área (coordenadas)
timestring-Fecha/tiempo de la imagen
layerstringNoNDVICapa a mostrar
evalscriptstringNo-Script de evaluación personalizado

GET/plas/featureinfo

Descripción: Obtener información de features en coordenadas específicas

ParámetroTipoObligatorioDefaultDescripción
BBOXstring-Bounding box del área
timestring-Fecha/tiempo de la imagen
xnumber-Coordenada X del punto
ynumber-Coordenada Y del punto
widthnumber-Ancho de la imagen
heightnumber-Alto de la imagen
layerstringNoCapa a consultar (default: NDVI)

GET/plas/historicalinfo

Descripción: Obtener información histórica de features

ParámetroTipoObligatorioDefaultDescripción
BBOXstring-Bounding box del área
timestring-Fecha/tiempo de la imagen
xnumber-Coordenada X del punto
ynumber-Coordenada Y del punto
widthnumber-Ancho de la imagen
heightnumber-Alto de la imagen
layerstringNoCapa a consultar (default: NDVI)

GET/plas/getlegendgraphic

Descripción: Obtener gráfico de leyenda

Parámetros: Específicos de WMS GetLegendGraphic

GET/plas/getDates

Descripción: Obtener fechas disponibles en PLAS

Parámetros: Ninguno

Spider (Deprecado)

Controller: Spider

Descripción: Sensores IoT Spider - DEPRECADO

Nota: Este servicio está deprecado y puede ser removido en futuras versiones

GET/spider

Descripción: Obtener datos de sensores Spider

ParámetroTipoObligatorioDefaultDescripción
userstring-Usuario Spider
passstring-Contraseña Spider (se hashea con MD5)
startstringNohace 1 mesFecha inicio (YYYYMMDD)
endstringNohace 1 mesFecha fin (YYYYMMDD)
bboxstringNo-Bounding box del área
widthnumberNo-Ancho de la imagen
heightnumberNo-Alto de la imagen
xnumberNo-Coordenada X
ynumberNo-Coordenada Y
Ejemplo:
https://tools.irricrops.com/spider?user=USERNAME&pass=PASSWORD&start=20250101&end=20250131

ZentraCloud

Controller: ZentraCloud

Descripción: Sensores Zentra Cloud

GET/zentracloud

Descripción: Obtener datos de sensores Zentra Cloud

ParámetroTipoObligatorioDefaultDescripción
tokenstringNotoken por defectoToken de autenticación Zentra Cloud
device_snstringNoz6-04229Número de serie del dispositivo
start_datestringNo2024-09-09Fecha inicio (YYYY-MM-DD)
end_datestringNo2024-09-10Fecha fin (YYYY-MM-DD)
output_formatstringNojsonFormato de salida (json/csv)
page_numnumberNo1Número de página para paginación
Ejemplo:
https://tools.irricrops.com/zentracloud?token=YOUR_TOKEN&device_sn=z6-04229&start_date=2025-01-01&end_date=2025-01-31

Información de Sensores

Controller: Sensors Info

Descripción: Endpoint de información general sobre todos los sensores disponibles

GET/sensors/info

Descripción: Obtener información completa sobre todos los endpoints de sensores disponibles, incluyendo categorías, parámetros y ejemplos

Parámetros: Ninguno

Respuesta: JSON con información detallada de todos los sensores, categorías, rutas disponibles, parámetros requeridos/opcionales y ejemplos de uso.

AgroClima

Controller: AgroClima

Descripción: Datos agroclimáticos

GET/agroclima/et

Descripción: Obtener datos de evapotranspiración agroclimática

ParámetroTipoObligatorioDefaultDescripción
formatstringNojsonFormato de respuesta (json/csv)
idCodEstnumberNo52Código de estación
Ejemplo:
https://tools.irricrops.com/agroclima/et?format=json&idCodEst=52

GET/agroclima/precipitacion

Descripción: Obtener datos de precipitación agroclimática

ParámetroTipoObligatorioDefaultDescripción
formatstringNojsonFormato de respuesta (json/csv)
idCodEstnumberNo52Código de estación

GET/agroclima/temp

Descripción: Obtener datos de temperatura agroclimática

ParámetroTipoObligatorioDefaultDescripción
formatstringNojsonFormato de respuesta (json/csv)
idCodEstnumberNo52Código de estación

AgroMeteorologia

Controller: AgroMeteorologia

Descripción: Datos meteorológicos agrícolas

GET/agrometeorologia/data

Descripción: Obtener datos meteorológicos agrícolas

ParámetroTipoObligatorioDefaultDescripción
codigostring-Código de la estación meteorológica
fecha_iniciostring-Fecha inicio (formato fecha válido)
fecha_finstring-Fecha fin (formato fecha válido)
Ejemplo:
https://tools.irricrops.com/agrometeorologia/data?codigo=EST001&fecha_inicio=2025-01-01&fecha_fin=2025-01-31

GET/agrometeorologia/estaciones

Descripción: Obtener lista de estaciones meteorológicas disponibles

Parámetros: Ninguno

Weather Underground

Controller: WU

Descripción: Datos Weather Underground - Evapotranspiración

GET/wu

Descripción: Obtener datos de evapotranspiración de Weather Underground

ParámetroTipoObligatorioDefaultDescripción
pwsstring-Weather Station ID (ej: KCOCORER4)
datestring-Fecha en formato YYYY-MM-DD
Ejemplo:
https://tools.irricrops.com/wu?pws=KCOCORER4&date=2025-09-01

World Weather Online

Controller: WorldWeatherOnline

Descripción: Pronóstico de temperatura con cálculo ET0 (Hargreaves) - Siempre 14 días

GET/worldweatheronline/forecast

Descripción: Obtener pronóstico de temperatura (min/max) con cálculo ET0 usando método Hargreaves

ParámetroTipoObligatorioDefaultDescripción
locationstring-Ubicación (ciudad, coordenadas, etc.)
keystring-API Key de World Weather Online
latitudnumberNo35 o extraída de coordenadasLatitud en grados para cálculo ET0
Ejemplo:
https://tools.irricrops.com/worldweatheronline/forecast?location=London&key=YOUR_API_KEY&latitud=51.5

IRRI (Riego IRRICROPS)

Controller: IRRI

Descripción: Control de sistemas de riego IRRICROPS

GET/irri

Descripción: Control de sistemas de riego IRRICROPS

ParámetroTipoObligatorioDefaultDescripción
userstring-Email de usuario IRRICROPS
passstring-Contraseña IRRICROPS
controller_idnumberNo-ID del controlador de riego
zonestringNo-Zona de riego (letra/número)
durationnumberNo-Duración del riego en minutos
Ejemplo:
https://tools.irricrops.com/irri?user=email@example.com&pass=PASSWORD&controller_id=123&zone=A&duration=30

GET/irri/status

Descripción: Estado de sistemas IRRICROPS

Parámetros: Ninguno

GET/irri/info

Descripción: Información de sistemas IRRICROPS

Parámetros: Ninguno

IP (Server IP)

Controller: IP

Descripción: Información de IP del servidor

GET/ip

Descripción: Obtiene la dirección IP del servidor

Pozos (TecnoAplica)

Controller: Pozos

Descripción: Monitoreo de pozos TecnoAplica

GET/pozos/data

Descripción: Obtener datos de monitoreo de pozos TecnoAplica

ParámetroTipoObligatorioDefaultDescripción
userstring-Usuario TecnoAplica
passstring-Contraseña TecnoAplica
startstring-Fecha inicio (formato fecha válido)
endstring-Fecha fin (formato fecha válido)
idPozostring-ID del pozo a consultar
Ejemplo:
https://tools.irricrops.com/pozos/data?user=USERNAME&pass=PASSWORD&start=2025-01-01&end=2025-01-31&idPozo=123

GET/pozos/list

Descripción: Obtener lista de pozos disponibles

Parámetros: Ninguno (requiere autenticación en el sistema TecnoAplica)

GET/pozos/status

Descripción: Estado del sistema de pozos

Parámetros: Ninguno

GET/pozos/info

Descripción: Información general del sistema de pozos

Parámetros: Ninguno

WL (WeatherLink)

Controller: WL

Descripción: Datos de niveles de agua WeatherLink

GET/wl/data

Descripción: Obtener datos de niveles de agua WeatherLink

ParámetroTipoObligatorioDefaultDescripción
userstring-Usuario WeatherLink
passstring-Contraseña WeatherLink
idstringNo-ID del dispositivo específico
startnumberNohace 1 mesTimestamp inicio (epoch en ms)
endnumberNoahoraTimestamp fin (epoch en ms)
Ejemplo:
https://tools.irricrops.com/wl/data?user=USERNAME&pass=PASSWORD&id=DEVICE123&start=1735689600000&end=1738368000000

GET/wl/devices

Descripción: Obtener lista de dispositivos WeatherLink disponibles

ParámetroTipoObligatorioDefaultDescripción
userstringUsuario WeatherLink
passstringContraseña WeatherLink
Ejemplo:
https://tools.irricrops.com/wl/devices?user=USERNAME&pass=PASSWORD

Dream (Talgil)

Controller: Dream

Descripción: Servicios externos Talgil

Autenticación: Requerida (token o api_key en header TLG-API-Key)

GET/dream/data

Descripción: Obtener datos generales de programas de riego Dream Talgil

ParámetroTipoObligatorioDefaultDescripción
tokenstring-Token de API Talgil (TLG-API-Key)
serialstring-Número de serie del dispositivo/objetivo
startstring-Fecha inicio (formato fecha válido con timezone)
endstring-Fecha fin (formato fecha válido con timezone)
Ejemplo:
https://tools.irricrops.com/dream/data?token=YOUR_TOKEN&serial=SERIAL123&start=2025-01-01&end=2025-01-31

GET/dream/targets

Descripción: Obtener lista de objetivos configurados del usuario

ParámetroTipoObligatorioDefaultDescripción
api_keystring-API Key de Talgil (TLG-API-Key)
Ejemplo:
https://tools.irricrops.com/dream/targets?api_key=YOUR_API_KEY

GET/dream/target

Descripción: Obtener datos de un objetivo específico

ParámetroTipoObligatorioDefaultDescripción
api_keystring-API Key de Talgil (TLG-API-Key)
target_idstring-ID del objetivo (serial)
Ejemplo:
https://tools.irricrops.com/dream/target?api_key=YOUR_API_KEY&target_id=SERIAL123

GET/dream/status

Descripción: Estado del servicio Dream Talgil

Parámetros: Ninguno

Utils

Controller: Utils

Descripción: Funciones utilitarias del sistema

GET/utils/ip

Descripción: Obtener información de IP del servidor y del cliente

Parámetros: Ninguno

Ejemplo:
https://tools.irricrops.com/utils/ip

GET/utils/info

Descripción: Obtener información general del servidor y endpoints disponibles

Parámetros: Ninguno

Ejemplo:
https://tools.irricrops.com/utils/info

GET/utils/time

Descripción: Obtener tiempo actual del servidor en múltiples formatos

Parámetros: Ninguno

Ejemplo:
https://tools.irricrops.com/utils/time

GET/utils/version

Descripción: Obtener información de versión del sistema, Node.js, plataforma y memoria

Parámetros: Ninguno

Ejemplo:
https://tools.irricrops.com/utils/version

Notas Importantes