Intelligence API

La referencia de la API de inteligencia de EchoSistema: 105 engines de análisis, pronóstico, recomendación y riesgo detrás de una única superficie REST.

Qué es la Intelligence API

Una superficie REST única para análisis, pronóstico, recomendación y riesgo: envías los datos, eliges el engine y recibes el resultado.

Una llamada por pregunta

Cada engine responde una pregunta de negocio: quién va a dejar de comprar, cuánto vender el mes que viene, qué artículos van juntos, qué acceso es sospechoso. Son 105, en once grupos, y todos hablan el mismo protocolo: misma autenticación, mismo formato de envío, mismo formato de respuesta.

Tus datos, tal como ya los tienes

El envío es JSON con las filas embebidas o un archivo en multipart: JSON, CSV o Parquet, reconocido por el contenido y no por el nombre. No entrenas, no alojas y no versionas ningún modelo: mandas las filas y los parámetros del engine.

Asíncrono por defecto, síncrono cuando cabe

El envío devuelve un identificador al instante y el resultado queda disponible para lectura, con webhook y notificación en tiempo real cuando termina. Para lotes pequeños está el modo síncrono, y para probar está el dry-run, que no persiste nada.

Inicio rápido

POST /api/v1/rfm/process
$ curl -X POST https://intelligence.echosistema.live/api/v1/rfm/process \
    -H "X-TENANT-KEY: $TENANT_KEY" \
    -H "Content-Type: application/json" \
    -d '{ "params": { "bins": 5 },
         "data": [
           { "customer_id": "C001", "purchase_date": "2026-07-20", "amount": 100.0 },
           { "customer_id": "C002", "purchase_date": "2026-07-25", "amount": 200.0 }
         ] }'

# 202 { "process_uuid": "7f9c24e5-...", "result_url": "/api/v1/results/7f9c24e5-..." }

Autenticación

Clave de tenant X-TENANT-KEY
Token de usuario Bearer (RS256)
Validación GET /api/v1/auth

Códigos de estado

200 / 202 Éxito
401 / 403 / 404 Credencial y acceso
413 / 422 / 429 Validación y límites

¿Listo para empezar? Explora la referencia completa de la API.

Ver documentación

Changelog

v1
  • Superficie v1 documentada: autenticación por clave de tenant, Bearer y token de operador.
  • Catálogo con 105 engines en 11 grupos y POST /api/v1//process en tres modos (async, sync, dry_run).
  • Resultados con paginación por keyset, claim-check para payloads grandes y burn-on-read para efímeros.
  • Webhook firmado (HMAC-SHA256), push sin datos de negocio y canal realtime por ticket de un solo uso.

Entrar

Usa tu cuenta EchoSistema para seguir tus integraciones.