La interfaz de PlantCare Enterprise se basa en un diseño OpenAPI (Swagger) que permite a las empresas ingerir directamente nuestro motor de modelado predictivo de alta precisión.
Explore la interfaz interactiva Swagger UI#
La documentación completa y la suite de pruebas están disponibles a través de nuestros puntos finales estándar.
- Puede acceder a la Definición Unificada de la API en:
https://api.plantcare.farm/v1/swagger.yaml
- Utilice los puntos finales de la Versión 1 (Estandarizada):
/v1/analyses/sync, /v1/history, /v1/stats y la suite de /v1/iot/devices.
Optimización de Imagen#
Para proporcionar el mejor rendimiento y reducir el ancho de banda, nuestra API Enterprise optimiza automáticamente todas las imágenes entrantes:
- Formato: Todas las imágenes se convierten a WebP (Calidad 92).
- Resolución: Redimensionadas a un máximo de 1024×1024 px manteniendo la relación de aspecto.
- Privacidad: Todo el procesamiento ocurre dentro de nuestra red privada segura y está protegido por tokens de identidad OIDC.
Seguridad y Cumplimiento#
Nuestra API está diseñada para entornos de alta seguridad. Obtenga más información sobre nuestro modelo Zero Trust de Seguridad y Autorización.
Flujo de Trabajo B2B#
sequenceDiagram
participant Client as "Cliente Enterprise"
participant API as "API Gateway"
participant GCS as "Cloud Storage"
participant Scan as "Malware Scanner"
participant Proc as "Procesador de Imágenes"
participant AI as "Motor de IA"
Client->>API: "POST /v1/analyses/sync (x-api-key)"
API->>GCS: "Cargar Imagen (Temp)"
Note over GCS,Scan: "GCS Trigger: scanNewFile"
Scan->>Scan: "Escanear en busca de Malware"
API->>Proc: "Solicitar Optimización (OIDC Auth)"
Proc->>Proc: "Convertir a WebP (92%, 1024px)"
Proc-->>API: "URL de Imagen Optimizada"
API->>AI: "Analizar con Imagen WebP"
AI-->>API: "Resultados del Análisis"
API-->>Client: "JSON (Diagnóstico + Ruta WebP)"
Note over API,Proc: "La imagen original se elimina en 24h"
Inicio Rápido#
curl -X POST https://api.plantcare.farm/v1/analyses/sync \
-H "x-api-key: pk_ent_your_token_here" \
-H "Content-Type: application/json" \
-d '{
"imageBase64": "...",
"sunExposure": "Pleno Sol",
"latitude": 40.7128,
"longitude": -74.0060,
"placement": "exterior",
"language": "es"
}'
Arquitectura Enterprise#
Obtenga más información sobre nuestro Middleware de Seguridad, Escalabilidad y Webhooks Basados en Eventos en la sección Arquitectura y Escalabilidad.
Si necesita acceso a una cuenta Enterprise, comuníquese con nuestro equipo de ventas global.
La API de PlantCare Enterprise implementa un modelo de seguridad Zero Trust. Cada solicitud se autentica en múltiples capas para garantizar la integridad y privacidad de los datos.
1. Autorización de Cliente a API (Claves API) Los clientes se autentican con una clave permanente pk_ent_ proporcionada durante el registro. Esta clave es validada por el Google Cloud API Gateway.
sequenceDiagram participant Client as Cliente participant GW as "API Gateway" participant KV as "Secret Manager" participant API as "Servicio Backend" Client->>GW: "Solicitud con Bearer pk_ent_..." GW->>KV: "Validar Clave y Permisos" alt "Clave Válida" GW->>API: "Proxy de Solicitud + Encabezados de Identidad" else "Clave Inválida" GW-->>Client: "401 No Autorizado" end 2. Seguridad de Almacenamiento (Escaneo de Malware) Cada imagen cargada en la API Enterprise se escanea automáticamente en busca de virus y malware antes de ser procesada. Esto se gestiona mediante un Disparador de Cloud Storage asíncrono.
...
La API PlantCare Enterprise se basa en una arquitectura Nativa de la Nube y Sin Estado, diseñada para manejar cargas masivas de IoT con tiempo de inactividad cero.
1. Seguridad en el Borde (Edge) y Mediciones Cada solicitud a nuestros puntos finales Enterprise es interceptada por un Middleware de Seguridad de alto rendimiento que aplica políticas de seguridad y cuotas de uso en el borde antes de que se ejecute cualquier lógica de negocio.
...