Desarrollo

Desarrollo (dev-api.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í emites tus propias Shop API Key y Widget Token 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.

Flujo recomendado

1. Solicitar acceso DEV -> recibir invite al Dashboard
2. Provisionar Shop DEV con datos sintéticos (10-50 productos)
3. Generar sk_* DEV y Widget Token DEV
4. Apuntar tu integración a https://dev-api.neuroon.ai con esas claves
5. Validar: sync, search, suggestions, tracking, conversion
6. Repetir contra Producción con sk_* PROD

Variables de entorno sugeridas

Solo 3 variables por entorno. Las long-lived: URL base del API, shop ID y la Shop API Key (server-only):

# Desarrollo
NEUROON_API_URL=https://api.neuroon.ai
NEUROON_SHOP_ID=shop_dev_xxxxx
NEUROON_API_KEY=sk_dev_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# Producción
NEUROON_API_URL_PROD=https://api.neuroon.ai
NEUROON_SHOP_ID_PROD=shop_xxxxx
NEUROON_API_KEY_PROD=sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

¿Y el Widget Token? NO va aquí

El Widget Token vive 24 h. No es env var: tu servidor lo firma localmente con la Shop 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 está configurado por defecto contra Desarrollo. Si quieres probar un endpoint sin afectar a tu Producción, basta con que pegues una sk_* de Desarrollo.

Próximas lecturas

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