API-dokumentasjon

Koble til og arbeide med Shifton API

Shifton APIShifton API gir deg tilgang til alle nøkkelfunksjoner på plattformen — fra skjemalægging til integrasjoner med eksterneHR, lønnsystemer, oganalysesystemer.
Ved å bruke API-en kan du automatisere prosesser og koble Shifton med din bedrifts interne tjenester.


API-dokumentasjon

Vi støtter to versjoner av vår dokumentasjon:


Kom i gang

Skaff en API-nøkkel

I dine firma-innstillinger på Shifton-plattformen, generer enAPI-nøkkel.
Autorisasjon gjøres via headeren:

Authorization: Bearer {your_api_key}

Utfør din første forespørsel

For eksempel, for å hente en liste over ansatte:

GET /api/v1/employees
Host: api2.shifton.com
Authorization: Bearer {your_api_key}

Eksempelsvar:

{
"data": [
{
"id": 101,
"name": "Alice Johnson",
"position": "HR Manager"
},
{
"id": 102,
"name": "Bob Smith",
"position": "Cashier"
}
]
}

Integrer API-et i dine arbeidsflyt

  • Automatisk opprette og endre skift

  • Administrere ferie- og sykemeldingsforespørsler

  • Eksporter data til lønnsystemer

  • Bygg tilpassede dashbord og rapporter


Kjerne-API-funksjoner

  • Ansatte – legg til, rediger og administrer roller

  • Tidsplaner – opprett, juster skift, planlegg arbeid

  • Ferie og fravær – administrer forespørsler om ferie og sykedager

  • Rapportering – eksporter tids-, lønns- og oppmøtedata


Feilkoder

Shifton API bruker standard HTTP-statuskoder:

  • 200 — Vellykket forespørsel

  • 201 — Objektet ble opprettet

  • 400 — Ugyldige parametere

  • 401 — Autoriseringsfeil (ugyldig API-nøkkel)

  • 403 — Tilgang nektet

  • 404 — Ressurs ikke funnet

  • 500 — Serverfeil


Brukstips

  • Bruk alltid den nye API-versjonen for nye integrasjoner

  • Bruk Postman eller curl for testing

  • Respekter fartsgrenser for å unngå å bli blokkert

  • Oppdater integrasjoner som fortsatt er avhengige av den gamle dokumentasjonen


Del dette innlegget