API Dokumentasie

Koppel en Werk met die Shifton API

Die Shifton API gee jou toegang tot al die sleutelfunksies van die platform — van skedulebestuur tot integrasies met eksterne HR, betaalstaat, en analistiese stelsels.
Deur die API te gebruik, kan jy prosesse outomatiseer en Shifton met jou maatskappy se interne dienste koppel.

API Dokumentasie

Ons ondersteun twee weergawes van ons dokumentasie:

• 📄 Ou Dokumentasie — die vorige weergawe van die API-verw. (nog steeds ondersteun vir bestaande integrasies):
  👉 https://api2.shifton.com/docs/?_gl=1*1p5sxoh*_gcl_au*NTAxMjY4NzA0LjE3NTcwNzUzMjAuMTI5NjMwODcwMS4xNzU4MjcxOTkzLjE3NTgyNzE5OTI.*_ga*NTE5MDI0OTM2LjE3NTcwNzUzMjA.*_ga_1M7TJQ7HY8*czE3NTg2MjA4MDUkbzU1JGcxJHQxNzU4NjIwOTE5JGo2MCRsMCRoNjU1OTcyMjMw#/en/v1/

• 🚀 Nuwe Dokumentasie — die huidige weergawe van die API met ‘n opgedateerde struktuur en die nuutste metodes:
  👉 https://api2.shifton.com/openapi/?_gl=1*1p5sxoh*_gcl_au*NTAxMjY4NzA0LjE3NTcwNzUzMjAuMTI5NjMwODcwMS4xNzU4MjcxOTkzLjE3NTgyNzE5OTI.*_ga*NTE5MDI0OTM2LjE3NTcwNzUzMjA.*_ga_1M7TJQ7HY8*czE3NTg2MjA4MDUkbzU1JGcxJHQxNzU4NjIwOTE5JGo2MCRsMCRoNjU1OTcyMjMw#/

Aan die Slag

Verkry ‘n API Sleutel

In jou maatskappy-instellings op die Shifton-platform, genereer ‘n API-sleutel.
Magtiging word via die opskrif gedoen:

Maak Jou Eerste Versoek

Byvoorbeeld, om ‘n lys van werknemers te kry:

Voorbeeld reaksie:

Integreer die API in Jou Werkvloei

• Skep en verander skofte outomaties

• Bestuur vakansie- en siekteverlof aansoeke

• Voer data uit na betaalstelsel stelsels

• Bou pasgemaakte dashboards en verslae

Kern-API-vermoëns

• Werknemers – voeg by, wysig en bestuur rolle

• Skedules – skep, pas skofte aan, beplan werk

• Verlof & Afwesighede – bestuur vakansie- en siekteverlof versoeke

• Verslae – voer tyd-, betaalstaat- en bywoningsdata uit

Foutkodes

Shifton API gebruik standaard HTTP statuskodes:

• 200 — Suksesvolle versoek

• 201 — Oorleg suksesvol geskep

• 400 — Ongeldige parameters

• 401 — Magtigingsfout (ongeldige API-sleutel)

• 403 — Toegang geweier

• 404 — Hulpbron nie gevind nie

• 500 — Bedienerfout

Gebruikswenke

• Gebruik altyd die nuwe API weergawe vir nuwe integrasies

• Gebruik Postman of curl vir toetsing

• Respekteer tydslimiete om te voorkom dat jy geblokkeer word

• Werk integrasies op wat steeds op die ou dokumentasie staatmaak