Cómo activar tu API Key de CDTEC IF
Actualizada el 22 oct
Tu API Key te permite consultar tus datos de CDTEC IF desde tus propios sistemas. La activas en el pop-up de perfil → API, con el botón Generar llave. La llave se muestra una sola vez: cópiala y guárdala en un lugar seguro.
1. ¿Qué es la API Key?
Es una llave de solo lectura: permite leer los mismos campos, sectores, lecturas, clima y riegos que ves en CDTEC IF, sin modificar nada.
Queda ligada a una cuenta y registrada a tu nombre: todo lo que se consulte con ella se considera hecho por ti.
Tiene topes de uso de 60 consultas por minuto y 10.000 por día.
2. Antes de empezar
Tu usuario de CDTEC IF con sesión iniciada.
Un lugar seguro para guardar la llave, por ejemplo un gestor de contraseñas o de secretos.
Importante: la llave se muestra una sola vez y CDTEC IF no puede recuperarla. Si la pierdes, tendrás que revocarla y crear otra.
3. Paso a paso
A. Entrar a la sección API
En la esquina inferior izquierda, haz clic en tu nombre de usuario para abrir el pop-up de perfil.
En el pop-up aparecen Mi cuenta, API, Mis avisos y Cerrar sesión. Haz clic en API.
Se abre la página API para clientes. Mientras no actives tu llave verás la etiqueta Sin llave.
Figura 1 · Pop-up de perfil
Figura 2 · Página «API para clientes» antes de generar la llave
B. Generar la llave
Haz clic en Generar llave. Se abre la ventana «Generar tu llave de la API».
Lee el compromiso de responsabilidad y marca Acepto: soy responsable de esta llave.
Haz clic en Generar llave. El botón se habilita solo después de marcar Acepto.
Figura 3 · Ventana «Generar tu llave de la API», lista para generar
C. Copiar y guardar la llave
Aparece la ventana Llave creada con tu llave completa (comienza con
cdtec_).Haz clic en Copiar llave y guárdala de inmediato en tu lugar seguro.
Marca Ya la guardé en un lugar seguro y haz clic en Cerrar. El botón Cerrar se habilita solo después de marcar esa casilla.
Figura 4 · Ventana «Llave creada» (llave oculta en esta guía)
Importante: después de cerrar esta ventana la llave ya no se vuelve a mostrar completa; solo verás su inicio, por ejemplo
cdtec_xxxxxxxx_••••.
D. Revisar tu llave activa
Al cerrar la ventana, la página API muestra tu llave como Activa con sus datos:
Cuenta: La cuenta cuyos datos entrega la llave
Generada · Último uso: Fecha de creación y de la última consulta
Topes: 60 por minuto · 10.000 por día
Rotar llave · Revocar: Reemplazar la llave por una nueva o anularla
Uso en los últimos 30 días: Resumen de las consultas realizadas
Figura 5 · Llave activa en la página «API para clientes»
4. Cómo usar la llave
Envía la llave en el encabezado X-Api-Key de cada consulta a la URL base:
URL base:
https://api.cdtecif.cl/v1Encabezado:
X-Api-Key: <tu llave>Documentación: Botón Documentación para desarrolladores en la página API
Ejemplo de primera consulta (datos de tu cuenta):
curl -H "X-Api-Key: cdtec_xxxxxxxx_••••••••••••••••" https://api.cdtecif.cl/v1/cuenta✓ Tu llave funciona si esta consulta responde con los datos de tu cuenta y en la página API cambia el Último uso.
5. Seguridad y solución de problemas
El botón Generar llave no se habilita: Falta marcar Acepto: soy responsable de esta llave
No ves la opción API en tu perfil: CDTEC aún no habilita la API para tu usuario. Pídela a soporte.
Perdiste la llave: No se puede recuperar: revócala y genera otra, o usa Rotar llave
Crees que la llave se filtró: Rótala o revócala de inmediato
Ya no necesitas el acceso: Usa Revocar; la llave deja de funcionar
La API rechaza la consulta: Revisa que la llave vaya completa en el encabezado X-Api-Key
No pongas la llave en código fuente ni la compartas. Si una integración la necesita, guárdala como variable de entorno o en un gestor de secretos.