Sandbox (ambiente de teste)
As chaves kinmu_sk_test_ nunca operam sobre dados reais: seu tenant é uma empresa sandbox com dados sintéticos (funcionários demo, pontos e ausências de exemplo) provisionada automaticamente ao ativar o addon. Use-a para desenvolver e testar sua integração.
- Pode ser resetada pelo painel (my.kinmu.app → Desenvolvedores).
- Limites mais baixos que produção: 30 req/min e 5.000 req/mês (veja rate limits).
Se uma chave test for usada sem sandbox provisionada, a API responde 401 (fail-closed) — nunca recai sobre dados reais.
Use chaves de teste para desenvolver e nos seus pipelines de CI; reserve as chaves live para produção. Todo o resto (endpoints, scopes, shapes) é idêntico entre sandbox e produção.
Ciclo de vida
A sandbox está presa ao addon Public API: é aprovisionada quando o ativa e desaprovisionada quando o desativa. Desativar o addon não é uma pausa, é uma eliminação.
Ao desativá-lo:
- São revogadas todas as chaves de API da empresa —
liveetest— com o motivoaddon_disabled. Voltar a ativar o addon não as ressuscita: é preciso emitir chaves novas e voltar a fazer o deploy das integrações. - São eliminados todos os relatórios gerados e os seus URLs de download deixam de resolver. Descarregue antes o que precisar de guardar.
- É eliminada a empresa sandbox com todos os seus dados (colaboradores de demonstração, picagens, ausências e o que tiver criado). Ao reativar o addon é aprovisionada vazia, com dados sintéticos novos: os IDs anteriores já não existem.
Desativar o addon deixa produção e sandbox fora de serviço ao mesmo tempo e, quanto a dados, é irreversível. Não o use como interruptor de manutenção: para cortar uma integração concreta, revogue a chave dela.
Um reset da sandbox a partir do painel é outra coisa: esvazia e regenera os dados de teste, mas não mexe nas suas chaves de API.