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 (tu stack).
   • 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

# Desarrollo
NEUROON_API_URL=https://dev-api.neuroon.ai
NEUROON_SHOP_ID=shop_dev_xxxxx
NEUROON_API_KEY=sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
# Widget Token: Base64(shopId:timestamp:HMAC-SHA256), TTL 24h. Emítelo desde tu servidor.
NEUROON_WIDGET_TOKEN=c2hvcF9kZXY6MTcxNTI3MDQwMDpkZXZzaWduYXR1cmU=

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

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.