Arquitectura

Neuroon vive entre dos puntas de tu integración: el navegador del comprador (donde corre el widget, ya empaquetado) y tu servidor (donde tienes tu catálogo). Sólo tu servidor habla con la API de Neuroon — el comprador nunca ve tu Shop API Key.

Vista de bloques

Pasa el cursor o haz click sobre un flujo para ver el detalle.

La API que tú integras

API	Prefijo	Quién la llama	Credencial
Plugin	/api/plugin/shops/*	Tu servidor	X-Shop-API-Key permanente + validación de origen

Tu servidor habla HTTPS contra api.neuroon.ai. Las llamadas del widget al backend (búsquedas, tracking) las gestiona el bundle del widget internamente con el X-Widget-Token que tú le inyectas en data-token — tú no tienes que codificarlas.

Flujo end-to-end resumido

1. Tú actualizas el catálogo: tu servidor llama a la Plugin API con products/sync (lotes de hasta 500). El producto es buscable en 2 a 5 segundos.
2. El comprador busca: el widget renderiza resultados. Tú no haces nada — el widget ya gestiona la llamada a Neuroon.
3. El comprador compra: tu servidor llama a la Plugin API con track/conversion para cerrar el bucle.

Eventual consistency

Tras 200 OK en products/sync hay una ventana corta antes de que el producto sea buscable. Si tu test E2E falla buscando un producto recién insertado, espera unos segundos y reintenta con backoff.

Sin versionado en URL

No existe /v1/, /v2/. Compatibilidad por contrato; los cambios breaking se anuncian con antelación en el Changelog.

Próximas lecturas

• Quickstart — del cero a la primera búsqueda en 5 minutos.
• Entornos — Producción vs Desarrollo.
• Autenticación · Visión general — qué credencial usar y cuándo.