Saltar al contenido principal

Changelog

Este changelog combina cambios relevantes para integradores en la API HTTP (api.neuroon.ai) y en el widget (cdn.neuroon.ai/widget/widget.js).

Formato: las versiones del widget siguen SemVer. La API HTTP no tiene versionado en la URL; los cambios breaking se anuncian explícitamente aquí con la marca BREAKING.

2026-05-06 — Documentación​

  • Corrección: rate limits son por endpoint (no por plan). Documentación actualizada con valores exactos del backend.
  • Corrección: plugin WordPress real es neuroon-search v0.8.4 (la documentación previa decía v1.0.6).
  • Corrección: la API no emite el header X-RateLimit-Reset. Sólo se setean X-RateLimit-Limit, X-RateLimit-Remaining y Retry-After (en 429).
  • Corrección: el cuerpo de error 429 tiene la forma { error, message, retryAfter, limit, remaining, timestamp }, no la envoltura estándar { timestamp, status, error, message, path }.
  • Adición: documentado la lista de dominios "trusted" (localhost, 127.0.0.1, neuroon.ai con coincidencia por suffix) y aclarado que sólo aplica al widget token, no a la Shop API Key.
  • Adición: clarificada la diferencia entre rate limit (throttling por endpoint) y cuotas de plan (maxProducts, maxSearchesPerMonth retornadas por GET /api/plugin/shops/me).
  • Plugin separado neuroon-agentic-commerce v0.1.0 (UCP / AI agents, checkout para agentes) tendrá su propia sección en próxima iteración.

Documentación reescrita — 6 mayo 2026​

Reescritura completa de docs.neuroon.ai. Esta es la primera versión de la documentación verificada frase a frase contra el código fuente.

Widget​

0.9.10 — vigente​

  • Versión actual desplegada en https://cdn.neuroon.ai/widget@0.9.10/widget.js.
  • Preact + Shadow DOM aislado.
  • 9 idiomas: es, en eager; fr, de, it, pt, ca, eu, gl lazy.
  • 30+ CSS variables --nrn-* en formato RGB-triplet (--nrn-primary: 6 182 212).
  • CustomEvents: emite neuroon-theme-change; escucha neuroon:cart-update.
  • postMessage: recibe neuroon:setStyles y neuroon:setTheme desde el frame contenedor.
  • Configuración exclusivamente vía atributos data-* (data-token, data-container, data-theme, data-locale, data-api-url).

Versión confirmada.

API HTTP​

Estado actual — primera documentación rigurosa​

Es la primera vez que documentamos la API con el rigor adecuado. La API ya estaba en producción; lo que cambia es la documentación. Endpoints estables que cubrimos:

  • /api/widget/* — auth X-Widget-Token. Search (GET y POST), search audio, search visual, suggestions, suggest, trending, compare, cart cross-sell, tracking de clic, tracking de conversión, eventos de analytics individuales y batch.
  • /api/plugin/shops/* — auth X-Shop-API-Key con validación de Origin. Sync de productos (INCREMENTAL/FULL, máximo 500/lote), CRUD de productos, verificación de dominio, tracking de conversión, info de la tienda.

Convenciones​

  • Sin versionado en URL (/v1/).
  • Errores con estructura unificada { timestamp, status, error, message, path }.
  • Headers de rate limit X-RateLimit-Limit, X-RateLimit-Remaining, Retry-After (este último sólo en 429).
  • Eventual consistency en sync: 2–5 segundos entre 200 OK y disponibilidad en Neuroon.

Política de cambios​

  • Breaking changes en la API HTTP se anuncian aquí con un mínimo de 30 días de antelación, salvo correcciones de seguridad críticas.
  • Cambios menores (campos opcionales nuevos, headers nuevos, mejoras de errores) son aditivos y no requieren acción del integrador.
  • Versiones del widget siguen SemVer estricto. Las publicadas siempre tienen su SRI hash en el manifiesto del CDN.

Cómo seguir cambios​

  • Suscríbete al canal de notificaciones desde el Dashboard.
  • Sigue status.neuroon.ai para incidentes.
  • Para cambios urgentes contactamos directamente a los integradores activos por email.

Próximas lecturas​

Última actualización en