Ir al contenido
CDTEC IF · API para clientes

Primeros pasos

De cero a tu primera respuesta: pedir el acceso, generar la llave y consultar tus campos.

1. Pide el acceso a CDTEC

La API se habilita por usuario. Escribe a departamentoid@cdtec.cl (o a tu agrónomo de CDTEC) indicando con qué usuario de CDTEC IF vas a integrar. Un administrador de CDTEC le activa el acceso «Generar su propia llave de la API para clientes».

Usa un usuario dedicado a la integración Recomendamos crear en tu cuenta un usuario propio para la integración (por ejemplo integracion@tuempresa.cl) con acceso solo a los campos que necesita. La llave verá exactamente lo mismo que ese usuario, y si alguien deja la empresa no hay que rotar la llave de una persona.

2. Genera tu llave en Mi cuenta › API

  1. Entra a app.cdtecif.cl con el usuario habilitado.
  2. Abre el menú de tu nombre (arriba a la derecha) y elige API.
  3. Lee y acepta la declaración de responsabilidad y pulsa Generar llave.
  4. Copia la llave. Se muestra una sola vez: CDTEC no la puede recuperar. Si la pierdes, rótala (se genera otra y la anterior deja de servir).

La llave tiene esta forma: cdtec_3f9a1c2e_…43 caracteres…. Los 8 caracteres después de cdtec_ son el prefijo: es público y sirve para reconocerla en la pantalla; el resto es el secreto.

3. Tu primera petición

Comprueba que la llave funciona pidiendo la cuenta:

curl -H "X-Api-Key: cdtec_3f9a1c2e_TU_SECRETO" https://api.cdtecif.cl/v1/cuenta

Respuesta:

{
  "data": {
    "id": "66f1c0a2b3d4e5f6a7b8c9d0",
    "nombre": "Agrícola Los Robles",
    "cantidadCampos": 3,
    "llave": { "nombre": "Llave de integracion@losrobles.cl (Mi cuenta › API)", "prefijo": "3f9a1c2e", "scopes": ["lectura"], "expiraEn": null }
  }
}

4. Recorre tus datos

El camino normal es campos → sectores o equipos → lecturas:

# Tus campos
curl -H "X-Api-Key: $LLAVE" https://api.cdtecif.cl/v1/campos

# Sectores de un campo
curl -H "X-Api-Key: $LLAVE" https://api.cdtecif.cl/v1/campos/66f1.../sectores

# Humedad de suelo de un sector, por día, primera quincena de octubre
curl -H "X-Api-Key: $LLAVE" \
  "https://api.cdtecif.cl/v1/lecturas?sectorId=66f2...&tipoSensor=Soil%20Moisture&granularidad=dia&desde=2026-10-01T00:00:00-03:00&hasta=2026-10-16T00:00:00-03:00"

Cada fila de lecturas trae fecha y hora en la hora del campo, inicio como instante real (ISO 8601 en UTC) y los agregados promedio, minimo, maximo, ultimo, suma y cantidad. Detalles en Zona horaria y unidades.

5. Siguientes pasos