API Dokumentation

Tilslutning og Arbejde med Shifton API’en

DetShifton API giver dig adgang til alle nøglefunktioner på platformen – fra skemastyring til integrationer med eksterneHR, -løn– oganalyse-systemer..
Ved at bruge API’en kan du automatisere processer og forbinde Shifton med din virksomheds interne tjenester.


API Dokumentation

Vi understøtter to versioner af vores dokumentation:


Kom i Gang

Få en API-nøgle

I dine virksomhedsindstillinger på Shifton platformen, generer enAPI-nøgle..
Autorisation udføres via headeren:

Authorization: Bearer {your_api_key}

Foretag Din Første Forespørgsel

For eksempel, for at hente en liste over medarbejdere:

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

Eksempel på svar:

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

Integrer API’en i Dine Arbejdsgange

  • Opret og ændr automatisk vagter

  • Administrer ferie- og sygefraværsanmodninger

  • Eksportér data til lønsystemer

  • Byg brugerdefinerede dashboards og rapporter


Kerne API-funktioner

  • Medarbejdere – tilføj, rediger og administrer roller

  • Skemaer – opret, juster vagter, planlæg arbejde

  • Ferie & Fravær – administrer ferie- og sygeorlovsanmodninger

  • Rapportering – eksportér tid, løn, og mødedata


Fejlkoder

Shifton API bruger standard HTTP statuskoder:

  • 200 — Vellykket anmodning

  • 201 — Objekt succesfuldt oprettet

  • 400 — Ugyldige parametre

  • 401 — Autorisationsfejl (ugyldig API-nøgle)

  • 403 — Adgang nægtet

  • 404 — Ressource ikke fundet

  • 500 — Serverfejl


Brugertips

  • Brug altid den nye API-version til nye integrationer

  • Brug Postman eller curl til test

  • Overhold grænser for forespørgsler for at undgå at blive blokeret

  • Opdater integrationer, der stadig er afhængige af den gamle dokumentation


Del dette indlæg