Kinmu Public API
Integrera Kinmus tidrapportering med ditt lönesystem, din passerkontroll eller dina BI-verktyg. Ett versionerat REST-API med företagsnycklar, explicita scopes och signerade webhooks.
curl https://api.kinmu.app/v1/organization \
-H "Authorization: Bearer $KINMU_API_KEY"Börja här
Aktivera addonet, skapa en nyckel och gör ditt första anrop på cirka 5 minuter.
QuickstartScopes, rotation, sandbox och bästa praxis.
Autentisering och API-nycklarPaginering, fel, idempotens och rate limits.
KonventionerUtforska de 9 resurserna och testa varje endpoint.
Interaktiv referensIntegrera ditt användningsfall
Arbetade timmar, frånvaro och semestersaldon för din lönekörning.
Lön och lönebyråRegistrera stämplingar från spärrar, kort eller kiosker med POST /v1/check-ins.
Inkrementell synkronisering via polling för dina dashboards.
BI / Power BIVad v1 exponerar
Ytan i v1 är 9 REST-resurser under https://api.kinmu.app/v1:
| Resurs | Användning |
|---|---|
| Organization | Introspektion av nyckeln och företaget. |
| Employees | Skapa, avsluta och uppdatera medarbetare. |
| Check-ins | Stämplingshändelser (in/ut/rast) med källa. |
| Work summaries | Aggregerad arbetstid per period för lön. |
| Absences | Frånvaro: skapa, godkänn och avslå. |
| Vacation balances | Semestersaldon per medarbetare och år. |
| Locations / Units | Organisationsstruktur (endast läsning). |
| Reports | Asynkrona rapporter (lagstadgad tidregistrering, exporter). |
| Webhooks | Signerade utgående events (Standard Webhooks). |
Företaget härleds alltid från nyckeln. {companyId} förekommer aldrig i publika routes eller i bodyn.
Principer
- Fryst kontrakt. Det som ingår i v1 ändras aldrig på ett inkompatibelt sätt; varje deprecering annonseras 12 månader i förväg i changeloggen.
- Minsta möjliga behörighet. Varje nyckel har explicita scopes; utan rätt scope ingen åtkomst (
403 invalid_scope). - Allt granskningsloggas. Varje request med företagsnyckel loggas med
origin=public_api. - Samma regler som appen. Skrivningar via API:et går genom samma domänvalideringar som applikationen.