API och webhooks

Läs anställda, arbetsplatser, registreringar och kostnader till ditt eget system – ERP, fakturering eller rapportering. Webhooks meddelar starter och avslut direkt.

  • REST + JSON
  • Signerade webhooks
  • Ingår i betalda paket

1. Skapa en API-nyckel

Administratören skapar nyckeln i appen: Inställningar → API och webhooks → Skapa nyckel. Nyckeln visas bara en gång. Skicka den i varje anrop i rubriken Authorization: Bearer <nyckel>.

curl -H "Authorization: Bearer llk_..." \
  "https://leimauslaite.fi/app/api/v1/entries?from=2026-11-01&to=2026-11-30"

2. Resurser

AnropInnehållFält
GET /api/v1/employeesAnställdaid, namn, e-post, anställningsnummer, roll, aktiv, arbetsplatser
GET /api/v1/sitesArbetsplatserid, namn, adress, aktiv
GET /api/v1/entriesRegistreringarstart och slut (UTC), paus, minuter, arbetsplats, projekt, registreringssätt; parametrarna from, to (högst 93 dygn) och employeeId
GET /api/v1/expensesResor och kostnaderdag, typ, mängd, belopp, rutt, syfte, status, om kvitto finns; parametrarna from och to

Tiderna anges i UTC (ISO 8601), datumen i finsk tid. Utan parametrar returnerar entries och expenses de senaste 30 dagarna. Högst 600 anrop per minut och nyckel.

{
  "from": "2026-11-01",
  "to": "2026-11-30",
  "data": [
    {
      "id": "kA1b2C3d4E5f6",
      "employeeId": "uX9y8Z7w6V5u4",
      "siteId": "sQ1w2E3r4T5y6",
      "projectId": null,
      "start": "2026-11-03T05:30:00.000Z",
      "end": "2026-11-03T14:00:00.000Z",
      "breakMin": 30,
      "minutes": 480,
      "source": "device",
      "note": ""
    }
  ]
}

3. Webhooks

Lägg till adressen under Inställningar → API och webhooks → Lägg till webhook och välj händelserna. Adressen måste vara https. Svara med koden 2xx inom fem sekunder.

HändelseNär
entry.startedArbetet startat (enhet, telefon, NFC-tagg eller kiosk)
entry.endedArbetet avslutat
entry.createdRegistrering tillagd manuellt eller som text
entry.updatedFörmannen korrigerade en registrering
POST https://esimerkki.fi/leimauslaite-webhook
Content-Type: application/json
Leimauslaite-Event: entry.started
Leimauslaite-Signature: t=1794500000,v1=5f2c…

{"id":"evt…","type":"entry.started","created":"2026-11-03T05:30:01.120Z","data":{ …kirjaus kuten yllä… }}

Kontroll av signaturen

Beräkna HMAC-SHA256 med webhookens hemlighet av strängen <t>.<anropets innehåll> och jämför med värdet v1. Avvisa anrop som är äldre än fem minuter.

// Node.js
const crypto = require("crypto");
function verify(rawBody, header, secret) {
  const [, t, v1] = /^t=(\d+),v1=([0-9a-f]{64})$/.exec(header) || [];
  if (!t || Math.abs(Date.now() / 1000 - t) > 300) return false;   // enintään 5 min vanha
  const mac = crypto.createHmac("sha256", secret).update(t + "." + rawBody).digest("hex");
  return crypto.timingSafeEqual(Buffer.from(mac), Buffer.from(v1));
}

Felkoder

401 nyckel saknas eller har raderats · 402 paketet omfattar inte API:t · 404 okänd resurs · 422 felaktig parameter · 429 för många anrop. Felbeskrivningen finns i fältet error.

Frågor om API:t

Vad kostar API:t?

API:t och webhooks ingår i de betalda paketen (Liten, Tillväxt och Företag) utan tilläggsavgift.

Kan man ändra uppgifter via API:t?

Nej. API:t är endast för läsning, så nyckeln kan inte ändra eller radera registreringar. Ändringar görs i appen, så att korrigeringshistoriken bevaras.

Hur skyddas nyckeln?

Nyckeln visas bara en gång när den skapas, och tjänsten sparar endast en hash av den. Radera nyckeln under Inställningar genast om du misstänker att den hamnat i fel händer – anslutningarna slutar fungera omedelbart.

Vad händer om vår webhook-server är nere?

Ett misslyckat utskick görs om efter 1 min, 5 min, 30 min, 2 h och 12 h. Status för det senaste utskicket syns under Inställningar.

Överföring till löneprogrammet?

För Procountor och Netvisor finns en färdig löneprogramsintegration (10 €/mån). API:t passar för andra system: ERP, fakturering, rapportering och BI.

Koppla arbetstiderna till dina egna system

API:t ingår i de betalda paketen. Prova först gratis med 1–3 anställda.