API-dokumentation

Ansluta och arbeta med Shifton API

Shifton APIShifton API ger dig tillgång till alla viktiga funktioner på plattformen – från schemaläggning till integrationer med externaHR, lönehanteringssystem, ochanalytiska system.
Genom att använda API:et kan du automatisera processer och ansluta Shifton till ditt företags interna tjänster.

API-dokumentation

Vi stödjer två versioner av vår dokumentation:

• 📄 Gammal dokumentation – den tidigare versionen av API-dokumentationen (fortfarande stödd för befintliga integrationer):
  👉 https://api2.shifton.com/docs/?_gl=1*1p5sxoh*_gcl_au*NTAxMjY4NzA0LjE3NTcwNzUzMjAuMTI5NjMwODcwMS4xNzU4MjcxOTkzLjE3NTgyNzE5OTI.*_ga*NTE5MDI0OTM2LjE3NTcwNzUzMjA.*_ga_1M7TJQ7HY8*czE3NTg2MjA4MDUkbzU1JGcxJHQxNzU4NjIwOTE5JGo2MCRsMCRoNjU1OTcyMjMw#/en/v1/

• 🚀 Ny dokumentation – den aktuella versionen av API med en uppdaterad struktur och de senaste metoderna:
  👉 https://api2.shifton.com/openapi/?_gl=1*1p5sxoh*_gcl_au*NTAxMjY4NzA0LjE3NTcwNzUzMjAuMTI5NjMwODcwMS4xNzU4MjcxOTkzLjE3NTgyNzE5OTI.*_ga*NTE5MDI0OTM2LjE3NTcwNzUzMjA.*_ga_1M7TJQ7HY8*czE3NTg2MjA4MDUkbzU1JGcxJHQxNzU4NjIwOTE5JGo2MCRsMCRoNjU1OTcyMjMw#/

Kom igång

Skaffa en API-nyckel

I dina företagsinställningar på Shifton-plattformen, generera enAPI-nyckel.
Auktorisering görs via headern:

Gör din första begäran

Till exempel, för att hämta en lista över anställda:

Exempel på svar:

Integrera API i dina arbetsflöden

• Skapa och ändra skift automatiskt

• Hantera semester- och sjukdomsfrågor

• Exportera data till lönesystem

• Bygg anpassade instrumentpaneler och rapporter

Kärn-API-funktioner

• Anställda – lägga till, redigera och hantera roller

• Scheman – skapa, justera skift, planera arbete

• Ledighet & Frånvaro – hantera semester och sjukledighetsansökningar

• Rapportering – exportera tid, löner och närvarodata

Felkoder

Shifton API använder standardHTTP-statuskoder:

• 200 — Begäran lyckades

• 201 — Objektet skapades framgångsrikt

• 400 — Ogiltiga parametrar

• 401 — Auktoriseringsfel (ogiltig API-nyckel)

• 403 — Åtkomst nekad

• 404 — Resurs inte hittad

• 500 — Serverfel

Användartips

• Använd alltid dennya API-versionen för nya integrationer

• Använd Postman eller curl för testning

• Respektera hastighetsbegränsningar för att undvika att bli blockerad

• Uppdatera integrationer som fortfarande förlitar sig på den gamla dokumentationen