Sandbox (testomgeving)

Keys met kinmu_sk_test_ werken nooit op echte data: hun tenant is een sandboxbedrijf met synthetische data (demomedewerkers, voorbeeldklokkingen en -afwezigheden) dat automatisch wordt aangemaakt bij het activeren van de addon. Gebruik de sandbox om je integratie te ontwikkelen en te testen.

Te resetten vanuit het dashboard (my.kinmu.app → Developers).
Lagere limieten dan productie: 30 req/min en 5.000 req/maand (zie rate limits).

Wordt een test-key gebruikt zonder aangemaakte sandbox, dan antwoordt de API met 401 (fail-closed) — er wordt nooit teruggevallen op echte data.

Gebruik test-keys voor ontwikkeling en je CI-pipelines; reserveer live-keys voor productie. Al het overige (endpoints, scopes, shapes) is identiek tussen sandbox en productie.

Levenscyclus

De sandbox hangt aan de Public API-addon: hij wordt aangemaakt zodra je de addon inschakelt en opgeruimd zodra je hem uitschakelt. De addon uitschakelen is geen pauze, het is een verwijdering.

Bij het uitschakelen:

Worden alle API-keys van het bedrijf ingetrokken — live én test — met reden addon_disabled. De addon weer inschakelen brengt ze niet terug: je moet nieuwe keys uitgeven en je integraties opnieuw uitrollen.
Worden alle gegenereerde rapporten verwijderd en resolven hun download-URL’s niet meer. Download vooraf wat je wilt bewaren.
Wordt het sandboxbedrijf met al zijn data verwijderd (demomedewerkers, check-ins, verlof en wat je zelf hebt aangemaakt). Bij het opnieuw inschakelen komt er een leeg sandboxbedrijf met verse synthetische data: de oude ID’s bestaan niet meer.

De addon uitschakelen legt productie en sandbox tegelijk stil, en qua data is dat onomkeerbaar. Gebruik het niet als onderhoudsschakelaar: wil je één integratie stoppen, trek dan die key in.

Een reset van de sandbox vanuit het dashboard is iets anders: die wist en genereert de testdata opnieuw, maar laat je API-keys met rust.