API Documentatie

Verbinding maken en werken met de Shifton API

De Shifton API geeft je toegang tot alle belangrijke functies van het platform – van roosterbeheer tot integraties met externe HR, payroll en analysesystemen.
Door de API te gebruiken, kun je processen automatiseren en Shifton verbinden met de interne diensten van je bedrijf.

API Documentatie

We ondersteunen twee versies van onze documentatie:

• 📄 Oude Documentatie – de vorige versie van de API-referentie (nog steeds ondersteund voor bestaande integraties):
  👉 https://api2.shifton.com/docs/?_gl=1*1p5sxoh*_gcl_au*NTAxMjY4NzA0LjE3NTcwNzUzMjAuMTI5NjMwODcwMS4xNzU4MjcxOTkzLjE3NTgyNzE5OTI.*_ga*NTE5MDI0OTM2LjE3NTcwNzUzMjA.*_ga_1M7TJQ7HY8*czE3NTg2MjA4MDUkbzU1JGcxJHQxNzU4NjIwOTE5JGo2MCRsMCRoNjU1OTcyMjMw#/en/v1/

• 🚀 Nieuwe Documentatie – de huidige versie van de API met een bijgewerkte structuur en de nieuwste methoden:
  👉 https://api2.shifton.com/openapi/?_gl=1*1p5sxoh*_gcl_au*NTAxMjY4NzA0LjE3NTcwNzUzMjAuMTI5NjMwODcwMS4xNzU4MjcxOTkzLjE3NTgyNzE5OTI.*_ga*NTE5MDI0OTM2LjE3NTcwNzUzMjA.*_ga_1M7TJQ7HY8*czE3NTg2MjA4MDUkbzU1JGcxJHQxNzU4NjIwOTE5JGo2MCRsMCRoNjU1OTcyMjMw#/

Aan de slag

Verkrijg een API-sleutel

Genereer een API-sleutel in de instellingen van je bedrijf op het Shifton-platform.API-sleutel.
Autorisatie gebeurt via de header:

Doe je eerste aanvraag

Bijvoorbeeld, om een lijst van werknemers op te halen:

Voorbeeld van een reactie:

Integreer de API in je workflows

• Maak automatisch diensten aan en wijzig ze

• Beheer aanvragen voor vakantie en ziekteverlof

• Exporteer gegevens naar loonadministratiesystemen

• Bouw aangepaste dashboards en rapporten

Hoofd API-functionaliteiten

• Werknemers – toevoegen, bewerken en beheren van rollen

• Roosters – diensten aanmaken, aanpassen, werk plannen

• Vrije Tijd & Afwezigheden – beheer van vakanties en ziekteverlof aanvragen

• Rapportage – exporteer tijd-, loon- en aanwezigheidsgegevens

Foutcodes

Shifton API maakt gebruik van standaard HTTP-statuscodes:

• 200 — Succesvolle aanvraag

• 201 — Object succesvol aangemaakt

• 400 — Ongeldige parameters

• 401 — Autorisatiefout (ongeldige API-sleutel)

• 403 — Toegang geweigerd

• 404 — Bron niet gevonden

• 500 — Serverfout

Gebruiktips

• Gebruik altijd de nieuwe API-versie voor nieuwe integraties

• Gebruik Postman of curl voor testen

• Respecteer ratelimieten om blokkeren te vermijden

• Werk integraties bij die nog steeds op de oude documentatie vertrouwen