API dokumentáció

Kapcsolódás és munkavégzés a Shifton API-val

A Shifton API hozzáférést biztosít a platform összes kulcsfontosságú funkciójához — az ütemezés kezelésétől kezdve a külső integrációkig, mint például HR, bérszámfejtés, és analitikai rendszerek.
Az API használatával automatizálhatók a folyamatok, és összekapcsolhatja a Shifton-t vállalatának belső szolgáltatásaival.

API Dokumentáció

Két verziót támogatunk dokumentációból:

• 📄 Régi Dokumentáció — az API korábbi verziójának dokumentációja (továbbra is támogatott a meglévő integrációk számára):
  👉 https://api2.shifton.com/docs/?_gl=1*1p5sxoh*_gcl_au*NTAxMjY4NzA0LjE3NTcwNzUzMjAuMTI5NjMwODcwMS4xNzU4MjcxOTkzLjE3NTgyNzE5OTI.*_ga*NTE5MDI0OTM2LjE3NTcwNzUzMjA.*_ga_1M7TJQ7HY8*czE3NTg2MjA4MDUkbzU1JGcxJHQxNzU4NjIwOTE5JGo2MCRsMCRoNjU1OTcyMjMw#/en/v1/

• 🚀 Új Dokumentáció — az API jelenlegi verziója frissített struktúrával és a legújabb módszerekkel:
  👉 https://api2.shifton.com/openapi/?_gl=1*1p5sxoh*_gcl_au*NTAxMjY4NzA0LjE3NTcwNzUzMjAuMTI5NjMwODcwMS4xNzU4MjcxOTkzLjE3NTgyNzE5OTI.*_ga*NTE5MDI0OTM2LjE3NTcwNzUzMjA.*_ga_1M7TJQ7HY8*czE3NTg2MjA4MDUkbzU1JGcxJHQxNzU4NjIwOTE5JGo2MCRsMCRoNjU1OTcyMjMw#/

Kezdeti Lépések

API Kulcs Beszerzése

A Shifton platform vállalati beállításaiban generáljon egy API kulcsot.
Az autorizáció a fejlécen keresztül történik:

Első Kérdésének Elkészítése

Például egy alkalmazotti lista lekérdezéséhez:

Példa válasz:

Integrálja az API-t a Munkafolyamataiba

• Automatikusan hozza létre és módosítsa a műszakokat

• Kezelje a szabadság- és betegszabadság-kérelmeket

• Exportálja az adatokat bérszámfejtő rendszerekbe

• Egyéni műszerfalakat és jelentéseket készíthet

Alapvető API funkciók

• Munkatársak – hozzáadás, szerkesztés, és szerepkörök kezelése

• Beosztások – műszakok létrehozása, módosítása, munkatervezés

• Szabadságok és hiányzások – szabadság és betegszabadság kérelmek kezelése

• Jelentések – idő, bérszámfejtés és jelenlét adatok exportálása

Hibakódok

A Shifton API szabványos HTTP státuszkódokat:

• 200 — Kérelem sikeres

• 201 — Objektum sikeresen létrehozva

• 400 — Érvénytelen paraméterek

• 401 — Jogosultsági hiba (érvénytelen API kulcs)

• 403 — Hozzáférés megtagadva

• 404 — Erőforrás nem található

• 500 — Szerverhiba

Használati tippek

• Mindig az új API verziót használd az új integrációkhoz

• Használja a Postman-t vagy a curl-t a teszteléshez

• Tartsa tiszteletben a sebességkorlátozásokat hogy elkerülje a blokkolást

• Frissítse azokat az integrációkat, amelyek még mindig a régi dokumentációra támaszkodnak