Skip to Content
Sandbox

Sandbox (entorno de test)

Las keys kinmu_sk_test_ nunca operan sobre datos reales: su tenant es una empresa sandbox con datos sintéticos (empleados demo, fichajes y ausencias de ejemplo) que se auto-provisiona al activar el addon. Úsala para desarrollar y probar tu integración.

  • Reseteable desde el dashboard (my.kinmu.app → Desarrolladores).
  • Límites más bajos que producción: 30 req/min y 5.000 req/mes (ver rate limits).

Si una key test se usa sin sandbox provisionada, la API responde 401 (fail-closed) — nunca cae sobre datos reales.

Usa keys de test para desarrollar y para tus pipelines de CI; reserva las keys live para producción. Todo lo demás (endpoints, scopes, shapes) es idéntico entre sandbox y producción.

Ciclo de vida

La sandbox vive atada al addon Public API: se aprovisiona al activarlo y se deprovisiona al desactivarlo. Desactivar el addon no es una pausa, es un borrado.

Al desactivarlo:

  • Se revocan todas las API keys de la empresa —live y test— con motivo addon_disabled. Reactivar el addon no las resucita: hay que emitir keys nuevas y redesplegar las integraciones.
  • Se borran todos los informes generados y sus URLs de descarga dejan de resolver. Descarga antes lo que necesites conservar.
  • Se elimina la empresa sandbox con todos sus datos (empleados demo, fichajes, ausencias y lo que hayas creado tú). Al reactivar el addon se reprovisiona vacía, con datos sintéticos nuevos: los IDs anteriores ya no existen.

Desactivar el addon deja fuera de servicio producción y sandbox a la vez, y en cuanto a datos es irreversible. No lo uses como interruptor de mantenimiento: para cortar una integración concreta, revoca su key.

Un reset de la sandbox desde el dashboard es otra cosa: vacía y regenera los datos de prueba, pero no toca tus API keys.

Last updated on