Desarrollo

Desarrollo (dev.neuroon.ai) es un clúster gestionado por nuestra plataforma, separado de Producción, en el que iteramos con deploys continuos. Es el entorno recomendado para integrar y probar antes de tocar Producción.

URLs

Recurso	URL
API	https://dev-api.neuroon.ai
Dashboard	https://dev.neuroon.ai
CDN del widget	https://cdn.neuroon.ai (mismo CDN; cambia data-api-url)

Cómo solicitar acceso

Desarrollo no es de auto-servicio. Para que se te aprovisione una tienda y claves de Desarrollo:

1. Escribe a Soporte o a tu contacto comercial indicando:

• Nombre de la organización.
• Stack (Next.js, .NET, WordPress, etc.).
• Email del propietario de la integración.

2. Recibirás un invite al Dashboard de Desarrollo (https://dev.neuroon.ai).
3. Desde ahí obtienes tu API Key de Desarrollo.

Las credenciales de Desarrollo no son las mismas que las de Producción. Si ya operas en Producción, crearás un par adicional sólo para Desarrollo.

Limitaciones reales

Datos no persistentes

Desarrollo se redespliega con frecuencia. La base de datos puede vaciarse o migrarse en cualquier momento. No subas PII real ni catálogos de clientes finales a este entorno.

Performance variable

Como Desarrollo recibe deploys continuos, las latencias pueden subir de forma puntual durante un rollout o una migración. No uses Desarrollo para benchmarks.

• Sin SLA. Es un entorno de pruebas.
• Snapshots de base de datos no garantizados.
• Las claves de API de Desarrollo se invalidan si tu cuenta lleva mucho tiempo inactiva.
• El CDN sirve la misma versión del widget que Producción. Para probar versiones pre-release, fija widget@<version>/widget.js con la versión que te indiquemos.
• Cuotas fijas, independientes del plan: products/sync acepta lotes de hasta 50 productos (no 500 como en Producción) y hay un máximo de 40 búsquedas/día. Son límites del propio entorno de pruebas — no aumentan al subir de plan. Ver Cuotas de plan vs rate limit.

Flujo recomendado

1. Solicitar acceso DEV -> recibir invite al Dashboard
2. Provisionar Shop DEV con datos sintéticos (10-50 productos)
3. Obtener API Key DEV
4. Apuntar tu integración a https://dev.neuroon.ai con esa key
5. Validar: sync, search, suggestions, tracking, conversion
6. Repetir contra Producción con API Key PROD

Variables de entorno sugeridas

Solo 2 variables por entorno: URL base del API y la API Key (server-only):

# Desarrollo
NEUROON_API_URL=https://api.neuroon.ai
NEUROON_API_KEY=tu_api_key_dev

# Producción
NEUROON_API_URL=https://api.neuroon.ai
NEUROON_API_KEY=tu_api_key_prod

¿Y el Widget Token? NO va aquí

El Widget Token vive 24 h. No es env var: tu servidor lo firma localmente con la API Key (HMAC), lo cachea con margen (~23 h), y lo inyecta en el HTML al renderizar, dentro del atributo data-token del <script> del widget. Si lo cacheas como env var, tu integración se rompe sola en menos de un día. Patrón completo en Widget Token y Recipe · Server-to-server token.

Try It en la documentación

El playground "Try It" de los endpoints de la API usa el selector de entorno del navbar. Selecciona Development para probar contra dev.neuroon.ai sin afectar a tu Producción.

Próximas lecturas

• Producción
• Cambiar de entorno
• Soporte — para solicitar acceso.