Sandbox (ambiente di test)
Le chiavi kinmu_sk_test_ non operano mai su dati reali: il loro tenant è un’azienda sandbox con dati sintetici (dipendenti demo, timbrature e assenze di esempio) creata automaticamente all’attivazione dell’addon. Usala per sviluppare e testare la tua integrazione.
- Resettabile dalla dashboard (my.kinmu.app → Sviluppatori).
- Limiti più bassi della produzione: 30 req/min e 5.000 req/mese (vedi rate limit).
Se una chiave test viene usata senza sandbox creata, l’API risponde 401 (fail-closed) — non ricade mai sui dati reali.
Usa le chiavi di test per lo sviluppo e per le tue pipeline di CI; riserva le chiavi live alla produzione. Tutto il resto (endpoint, scopes, shape) è identico tra sandbox e produzione.
Ciclo di vita
La sandbox è legata all’addon Public API: viene creata quando lo attivi e smantellata quando lo disattivi. Disattivare l’addon non è una pausa, è una cancellazione.
Alla disattivazione:
- Vengono revocate tutte le API key dell’azienda —
liveetest— con motivoaddon_disabled. Riattivare l’addon non le resuscita: vanno emesse chiavi nuove e vanno ridistribuite le integrazioni. - Vengono cancellati tutti i report generati e i loro URL di download smettono di risolvere. Scarica prima ciò che ti serve conservare.
- Viene eliminata l’azienda sandbox con tutti i suoi dati (dipendenti demo, timbrature, assenze e quanto hai creato tu). Alla riattivazione viene ricreata vuota, con nuovi dati sintetici: gli ID precedenti non esistono più.
Disattivare l’addon mette fuori servizio produzione e sandbox insieme, ed è irreversibile sul fronte dati. Non usarlo come interruttore di manutenzione: per fermare una singola integrazione, revoca la sua chiave.
Un reset della sandbox dalla dashboard è un’altra cosa: svuota e rigenera i dati di prova, ma non tocca le tue API key.