Skip to content

Entornos ​

Nimobase se ejecuta en dos entornos: Producción y Sandbox. No eliges un host ni configuras una URL: el entorno se selecciona con una sola opción al crear el cliente del SDK.

Producción y Sandbox ​

EntornoPara qué sirve
ProducciónEl entorno real: los datos de tu empresa, los que usa tu equipo todos los días.
SandboxTu banco de pruebas: puedes romper cosas sin afectar a nadie, con datos separados.

Lo que ocurre en Sandbox queda en Sandbox. Los datos de los dos entornos están completamente separados, así que una prueba fallida nunca toca tu información real.

Cómo eliges el entorno ​

En el SDK la opción es sandbox: si la pones en true, vas a Sandbox; si la omites, vas a Producción.

ts
// Producción — el valor por defecto
const client = Nimobase({ secretKey: process.env.NIMOBASE_SECRET_KEY });

// Sandbox
const pruebas = Nimobase({
  secretKey: process.env.NIMOBASE_SECRET_KEY,
  sandbox: true,
});

No hay ninguna URL que configurar a mano: el cliente resuelve solo el destino del entorno que elegiste. La versión del contrato es una opción aparte — version (por ejemplo version: 'v1') — y si la omites usas la última publicada.

Qué NO cambia entre entornos ​

Los endpoints, los permisos y las claves funcionan igual en los dos entornos: misma ruta, mismo comportamiento, mismos roles. Lo único que cambia es el destino de los datos. Una integración que funciona en Sandbox funciona en Producción sin escribir una línea distinta.

Cuándo pasar a producción ​

  1. Prueba el flujo completo en Sandbox de punta a punta, no solo la llamada feliz: también los errores que tu integración tiene que manejar.
  2. Revisa los límites de tu plan en Billing antes de mover tráfico real.
  3. Recién entonces cambia la opción: quita sandbox: true y tu cliente apunta a Producción.

Las claves las crea y gestiona un OWNER o ADMIN de tu empresa en API Keys.