Sandbox (environnement de test)
Les clés kinmu_sk_test_ n’opèrent jamais sur des données réelles : leur tenant est une entreprise sandbox avec des données synthétiques (salariés de démo, pointages et absences d’exemple), provisionnée automatiquement à l’activation de l’addon. Utilisez-la pour développer et tester votre intégration.
- Réinitialisable depuis le dashboard (my.kinmu.app → Développeurs).
- Limites plus basses qu’en production : 30 req/min et 5 000 req/mois (voir limites de débit).
Si une clé test est utilisée sans sandbox provisionnée, l’API répond 401 (fail-closed) — elle ne retombe jamais sur des données réelles.
Utilisez des clés de test pour le développement et vos pipelines de CI ; réservez les clés live à la production. Tout le reste (endpoints, scopes, shapes) est identique entre sandbox et production.
Cycle de vie
La sandbox est liée à l’addon Public API : elle est provisionnée à l’activation et déprovisionnée à la désactivation. Désactiver l’addon n’est pas une mise en pause, c’est une suppression.
À la désactivation :
- Toutes les clés API de l’entreprise sont révoquées —
livecommetest— avec le motifaddon_disabled. Réactiver l’addon ne les ressuscite pas : il faut émettre de nouvelles clés et redéployer les intégrations. - Tous les rapports générés sont supprimés et leurs URL de téléchargement cessent de résoudre. Téléchargez au préalable ce que vous voulez conserver.
- L’entreprise sandbox est supprimée avec toutes ses données (salariés de démo, pointages, absences et ce que vous y avez créé). À la réactivation, elle est reprovisionnée vide, avec de nouvelles données synthétiques : les anciens ID n’existent plus.
Désactiver l’addon met la production et la sandbox hors service en même temps, et c’est irréversible côté données. Ne vous en servez pas comme d’un interrupteur de maintenance : pour couper une intégration précise, révoquez sa clé.
Un reset de la sandbox depuis le dashboard est autre chose : il vide et régénère les données de test, mais ne touche pas à vos clés API.