Preguntas Frecuentes sobre la API y Plataforma Enterprise
¿Qué es el plan Enterprise de PlantCare?
El plan Enterprise ofrece a empresas agrícolas, invernaderos comerciales y proveedores de analítica acceso directo a nuestra API REST conectada al backend de IA. Esto permite a las organizaciones integrar nuestros diagnósticos de fitopatología, recomendaciones de tratamiento y análisis de compatibilidad del suelo directamente en sus propios paneles de control o sistemas de gestión agrícola (FMS).
¿Cómo funcionan las notificaciones de webhooks?
El procesamiento de fotografías botánicas de alta resolución a través de redes neuronales puede tardar hasta 30 segundos. Para evitar consultas continuas o repetitivas (polling), los desarrolladores pueden registrar una URL de webhook en el Panel de control de Enterprise. En cuanto nuestro orquestador en segundo plano complete un análisis, enviará de forma automática una petición POST con el payload JSON que contiene todos los datos del diagnóstico directamente a su servidor.
¿Cómo se gestionan y miden los tokens de la API?
El acceso programático se autentica mediante tokens de API únicos generados en el Panel de control de Enterprise. Las solicitudes se descuentan de los límites de cuota mensuales acordados en su contrato. Si su sistema supera el límite asignado, la puerta de enlace de la API (API Gateway) responderá con un error 429 Too Many Requests. Puede monitorizar el consumo y el volumen de solicitudes en tiempo real desde el panel de control.
¿Cómo se garantiza el cumplimiento de GDPR y la privacidad de los datos?
Aplicamos un estricto estándar de privacidad por diseño (Privacy by Design). Por ejemplo, nuestra política de ubicación con persistencia cero garantiza que las coordenadas GPS exactas enviadas a nuestra API se utilicen únicamente de forma efímera para consultar los datos climáticos y del suelo necesarios para el análisis de IA, descartándose de inmediato. Solo se almacenan de forma permanente datos regionales generalizados (como la ciudad o la región/provincia/estado). Además, cuando se elimina una cuenta, se activa la anonimización automática de la telemetría botánica para colaborar con la investigación científica global de forma segura.
¿La plataforma admite seguridad sin claves estáticas (keyless)?
Sí. Para cumplir con un modelo de seguridad estricto de cero confianza y cero intervención (Zero-Trust, Zero-Touch), la infraestructura de PlantCare prohíbe por completo el uso de claves JSON estáticas para cuentas de servicio. Todas las integraciones con la nube y los flujos de CI/CD se autentican exclusivamente mediante la federación de identidades de carga de trabajo utilizando tokens firmados efímeros.
¿Cómo vinculamos dispositivos IoT a la plataforma?
Las cuentas Enterprise pueden registrar sensores IoT (humedad del suelo, temperatura, luminosidad) y cámaras desde la API o el Panel de control. Estos dispositivos se organizan bajo una jerarquía geográfica estricta: se vinculan a una Planta, que a su vez pertenece a un Lugar, dentro de una Ciudad, un Pago/País y un Proyecto. Los datos de telemetría de estos dispositivos se pueden enviar junto con las imágenes del análisis a nuestra IA para aumentar sustancialmente la precisión del diagnóstico.
¿Existe una política de reintento y retroceso para las solicitudes de API?
Sí. En caso de problemas de red temporales o de que se alcance el límite de peticiones en la IA, la puerta de enlace (gateway) gestiona los tiempos de espera y las políticas de reintento de manera dinámica. Recomendamos que los sistemas cliente implementen un algoritmo de retroceso exponencial estándar (exponential backoff) al gestionar respuestas temporales de error 503 o 429 de la API.