Saltar al contenido principal

Cómo obtener tu Shop API Key

Una Shop API Key (sk_…) es la única credencial que necesitas para integrar Neuroon. Vale para sincronizar productos, generar Widget Tokens, registrar conversiones y consultar tu cuota.

Pasos​

1. Crea tu cuenta​

Abre https://neuroon.ai/dashboard. Si es la primera vez, haz click en Empezar / Registrar y sigue el flujo (Google OAuth o email).

2. Registra tu tienda​

Una vez dentro, Tiendas → Crear tienda. Rellena:

  • Nombre: lo que tú quieras (no es público).
  • URL: el dominio canónico de tu tienda (https://tutienda.com). Importante: este dominio se usará para validar el widget. Si lanzas en staging.tutienda.com y tutienda.com, contacta a soporte para añadir orígenes adicionales.
  • Plataforma: WooCommerce, Shopify, BigCommerce o Genérico (custom). Si tu stack no está en la lista, elige Genérico.

3. Copia tu Shop API Key​

Tras crear la tienda, el dashboard muestra tu Shop API Key (sk_<32 hex>). Cópiala ahora, solo se muestra una vez. Si la pierdes, regenera (la antigua queda invalidada).

sk_a1b2c3d4e5f6789012345678901234ab

4. Guárdala como variable de entorno​

En tu servidor (NUNCA en frontend ni HTML):

# .env del backend
NEUROON_API_KEY=sk_a1b2c3d4e5f6789012345678901234ab
NEUROON_SHOP_ID=shop_xxxxxxxxxxxxxxxxxxxxx

shop_id se muestra junto a la key en el dashboard.

5. Verifica que funciona​

curl https://api.neuroon.ai/api/plugin/shops/me \
  -H "X-Shop-API-Key: $NEUROON_API_KEY"

Debería devolver 200 con tu shop info y cuotas. Si recibes 401, revisa la key.

Producción vs Desarrollo​

En el dashboard tienes el toggle Producción / Desarrollo. Cada entorno tiene su propia API Key y son independientes:

EntornoURL DashboardURL API
Producciónhttps://neuroon.ai/dashboardhttps://api.neuroon.ai
Desarrollohttps://dev.neuroon.ai/dashboardhttps://dev-api.neuroon.ai

Las keys siguen el mismo formato sk_<32hex> en ambos entornos. El shopId y la key son distintos por entorno, no intercambiables.

Empieza siempre integrando contra Desarrollo. Cuando todo funcione, cambia las URLs y la key a Producción.

Buenas prácticas​

  • Rota la key cada 6-12 meses o cuando un colaborador deja el equipo.
  • Una key por entorno (no compartir entre prod y dev).
  • No commitees la key a git. Usa .env ignorado por .gitignore o un secret manager.
  • No la imprimas en logs públicos, error pages o respuestas HTTP.

Siguientes pasos​

Tienes la API Key. Ahora ve al Quickstart para sincronizar tu primer producto y embeber el widget en 10 minutos.

Última actualización en