Variables de entorno

Las únicas variables de entorno que necesitas. Cópialas a tu .env (o secret manager).

Backend (server-side)

Estas dos viven en tu servidor. Nunca en el navegador.

Variable	Valor	Para qué
NEUROON_API_KEY	sk_… (mismo formato en ambos entornos)	Autentica todas las llamadas server-to-server
NEUROON_SHOP_ID	shop_…	Identifica tu tienda
NEUROON_API_URL	https://api.neuroon.ai o https://dev-api.neuroon.ai	Base URL del API

Frontend (browser)

El widget solo necesita el Widget Token (que tú generas server-side y le pasas como data-token). No hay otra var del lado cliente.

Variable	Valor	Para qué
NEUROON_WIDGET_TOKEN (server-side)	Token de 24 h	Tu servidor lo emite y lo imprime en el HTML como data-token

Por stack

Node / Express / NestJS

# .env
NEUROON_API_KEY=sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
NEUROON_SHOP_ID=shop_xxxxxxxxxxxxxxxxxxxxxxxxxxxx
NEUROON_API_URL=https://api.neuroon.ai

const res = await fetch(`${process.env.NEUROON_API_URL}/api/plugin/shops/${process.env.NEUROON_SHOP_ID}/products/sync`, {
  headers: { 'X-Shop-API-Key': process.env.NEUROON_API_KEY, ... }
})

Next.js

.env.local:

NEUROON_API_KEY=sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
NEUROON_SHOP_ID=shop_xxxxxxxxxxxxxxxxxxxxxxxxxxxx
NEUROON_API_URL=https://api.neuroon.ai

No prefijes con NEXT_PUBLIC_. Esto es server-only. Para emitir el Widget Token usa un Route Handler (app/api/.../route.ts) que lo devuelva al frontend.

.NET

appsettings.json (o un secret manager equivalente):

{
  "Neuroon": {
    "ApiKey": "sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "ShopId": "shop_xxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "ApiUrl": "https://api.neuroon.ai"
  }
}

var apiKey = configuration["Neuroon:ApiKey"];

PHP / WordPress

wp-config.php (preferido a guardar la key en wp_options):

define('NEUROON_API_KEY', 'sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx');
define('NEUROON_SHOP_ID', 'shop_xxxxxxxxxxxxxxxxxxxxxxxxxxxx');
define('NEUROON_API_URL', 'https://api.neuroon.ai');

Python / Django / Flask

# .env
NEUROON_API_KEY=sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
NEUROON_SHOP_ID=shop_xxxxxxxxxxxxxxxxxxxxxxxxxxxx
NEUROON_API_URL=https://api.neuroon.ai

import os
api_key = os.environ['NEUROON_API_KEY']

Cambiar entre Producción y Desarrollo

Solo cambias dos cosas:

- NEUROON_API_URL=https://dev-api.neuroon.ai
+ NEUROON_API_URL=https://api.neuroon.ai

- NEUROON_API_KEY=sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+ NEUROON_API_KEY=sk_xxxxxxxxxxxxxxxxxxxxxxxx

NEUROON_SHOP_ID puede ser distinto si has registrado tu tienda en ambos entornos por separado.

El CDN del widget (https://cdn.neuroon.ai/widget.js) es el mismo en producción y desarrollo.

Reglas

• Nunca las commitees a git. .env debe estar en .gitignore.
• Nunca las pongas en frontend (NEXT_PUBLIC_*, VITE_*, etc.) — todas son server-only.
• Nunca mezcles claves de Producción y Desarrollo.