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
| Entorno | Para qué sirve |
|---|---|
| Producción | El entorno real: los datos de tu empresa, los que usa tu equipo todos los días. |
| Sandbox | Tu 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.
// 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
- 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.
- Revisa los límites de tu plan en Billing antes de mover tráfico real.
- Recién entonces cambia la opción: quita
sandbox: truey tu cliente apunta a Producción.
Las claves las crea y gestiona un OWNER o ADMIN de tu empresa en API Keys.