Sandbox (Testumgebung)

Keys mit kinmu_sk_test_ arbeiten niemals auf echten Daten: Ihr Tenant ist ein Sandbox-Unternehmen mit synthetischen Daten (Demo-Mitarbeitende, Beispiel-Stempelungen und -Abwesenheiten), das beim Aktivieren des Addons automatisch provisioniert wird. Nutze es zum Entwickeln und Testen deiner Integration.

Zurücksetzbar über das Dashboard (my.kinmu.app → Entwickler).
Niedrigere Limits als in Produktion: 30 req/min und 5.000 req/Monat (siehe Rate Limits).

Wird ein test-Key ohne provisionierte Sandbox verwendet, antwortet die API mit 401 (fail-closed) — sie greift niemals auf echte Daten zurück.

Verwende Test-Keys zum Entwickeln und in deinen CI-Pipelines; reserviere live-Keys für die Produktion. Alles andere (Endpoints, Scopes, Shapes) ist zwischen Sandbox und Produktion identisch.

Lebenszyklus

Die Sandbox hängt am Addon Public API: Sie wird beim Aktivieren provisioniert und beim Deaktivieren deprovisioniert. Das Addon zu deaktivieren ist keine Pause, sondern eine Löschung.

Beim Deaktivieren:

Alle API-Keys des Unternehmens werden widerrufen — live wie test — mit dem Grund addon_disabled. Ein erneutes Aktivieren holt sie nicht zurück: Du musst neue Keys ausstellen und deine Integrationen neu ausrollen.
Alle erzeugten Reports werden gelöscht, ihre Download-URLs lösen nicht mehr auf. Lade vorher herunter, was du behalten willst.
Das Sandbox-Unternehmen wird mit allen Daten gelöscht (Demo-Mitarbeitende, Stempelungen, Abwesenheiten und alles, was du selbst angelegt hast). Beim erneuten Aktivieren wird eine leere Sandbox mit frischen synthetischen Daten provisioniert: Die alten IDs existieren nicht mehr.

Das Deaktivieren des Addons legt Produktion und Sandbox gleichzeitig still und ist, was die Daten angeht, unumkehrbar. Nutze es nicht als Wartungsschalter: Um eine einzelne Integration abzuschalten, widerrufe ihren Key.

Ein Reset der Sandbox über das Dashboard ist etwas anderes: Er leert und erzeugt die Testdaten neu, lässt deine API-Keys aber unangetastet.