API para clientes de CDTEC IF

Lee los datos de tus campos (sectores, equipos, lecturas de sensores, clima y riegos) desde tus propios sistemas: ERP, BI, planillas o scripts.

Solo lectura La API entrega datos; no programa riegos ni cambia nada en la plataforma. Cualquier método que no sea GET responde 405.

Qué puedes obtener

Recurso	Ruta	Qué entrega
Cuenta	`GET /cuenta`	La cuenta de la llave y cuántos campos puede leer. Sirve para probar la llave.
Campos	`GET /campos`, `GET /campos/{campoId}`	Tus campos con ubicación, superficie, centro y polígono.
Sectores	`GET /campos/{campoId}/sectores`	Sectores vigentes con variedad, año de plantación, configuración de riego y polígono.
Equipos	`GET /campos/{campoId}/equipos`	Sondas, sensores y estaciones con su tipo, estado y última actividad.
Estaciones	`GET /campos/{campoId}/estaciones`	Solo las estaciones de clima del campo.
Lecturas	`GET /lecturas`	Lecturas de un sector o equipo agregadas por hora o por día (promedio, mínimo, máximo, último, suma, cantidad).
Clima	`GET /estaciones/{estacionId}/clima`	Temperatura, humedad, lluvia, radiación, viento y más, por hora o por día.
Riegos	`GET /campos/{campoId}/riegos`	Riegos registrados (programados y manuales) con inicio, fin, volumen y precipitación.

Lo esencial en 30 segundos

URL base: https://api.cdtecif.cl/v1 (alias: https://app.cdtecif.cl/api/v1).
Autenticación: tu llave en el encabezado X-Api-Key (o Authorization: Bearer). La generas tú mismo en Mi cuenta › API de CDTEC IF, una vez que CDTEC te habilita el acceso.
Formato: JSON. Éxito { "data": … }; listas largas traen "paginacion": { "siguienteCursor" }; errores { "error": { "codigo", "mensaje" } }.
Límites: 60 peticiones por minuto y 10.000 por día por llave.
Rangos: hasta 31 días por consulta (7 días si pides por hora).
Alcance: la llave ve exactamente los campos que ve tu usuario en la plataforma. Lo que no es tuyo responde 404, igual que si no existiera.

Primeros pasosObtén tu llave y haz tu primera consulta en 5 minutos. ReferenciaTodas las rutas, parámetros y esquemas, generados desde el código. Ejemploscurl, Python y JavaScript listos para copiar.

Versión y compatibilidad

Esta es la versión v1. Los cambios compatibles (campos nuevos en las respuestas, rutas nuevas) se publican en el changelog sin cambiar la versión; un cambio incompatible saldría como /v2 con aviso previo. Tu integración debe ignorar los campos que no conozca.