Dokumentácia API

Pripojenie a práca s Shifton API

API systému Shifton vám poskytuje prístup ku všetkým kľúčovým funkciám platformy — od správy rozvrhu po integrácie s externými HR, mzdovými a analytickými systémami..
Použitím API môžete automatizovať procesy a pripojiť Shifton k interným službám vašej spoločnosti.

API Dokumentácia

Podporujeme dve verzie našej dokumentácie:

• 📄 Stará dokumentácia — predchádzajúca verzia referencie API (stále podporovaná pre existujúce integrácie):
  👉 https://api2.shifton.com/docs/?_gl=1*1p5sxoh*_gcl_au*NTAxMjY4NzA0LjE3NTcwNzUzMjAuMTI5NjMwODcwMS4xNzU4MjcxOTkzLjE3NTgyNzE5OTI.*_ga*NTE5MDI0OTM2LjE3NTcwNzUzMjA.*_ga_1M7TJQ7HY8*czE3NTg2MjA4MDUkbzU1JGcxJHQxNzU4NjIwOTE5JGo2MCRsMCRoNjU1OTcyMjMw#/en/v1/

• 🚀 Nová dokumentácia — aktuálna verzia API s aktualizovanou štruktúrou a najnovšími metódami:
  👉 https://api2.shifton.com/openapi/?_gl=1*1p5sxoh*_gcl_au*NTAxMjY4NzA0LjE3NTcwNzUzMjAuMTI5NjMwODcwMS4xNzU4MjcxOTkzLjE3NTgyNzE5OTI.*_ga*NTE5MDI0OTM2LjE3NTcwNzUzMjA.*_ga_1M7TJQ7HY8*czE3NTg2MjA4MDUkbzU1JGcxJHQxNzU4NjIwOTE5JGo2MCRsMCRoNjU1OTcyMjMw#/

Začíname

Získajte API kľúč

V nastaveniach vašej spoločnosti na platforme Shifton vytvorte API kľúč..
Autorizácia sa vykonáva cez hlavičku:

Vytvorte prvý dopyt

Napríklad na získanie zoznamu zamestnancov:

Príklad odpovede:

Integrujte API do svojich pracovných postupov

• Automaticky vytvárajte a upravujte smeny

• Spravujte žiadosti o dovolenku a práceneschopnosť

• Exportujte údaje do mzdových systémov

• Vytvárajte vlastné tabuľky a správy

Základné schopnosti API

• Zamestnanci – pridávať, upravovať a spravovať role

• Harmonogramy – vytvárať, upravovať zmeny, plánovať prácu

• Voľno a absencie – spravovať žiadosti o dovolenku a práceneschopnosť

• Reportovanie – export údajov o čase, mzdách a dochádzke

Chybové kódy

Shifton API používa štandardné HTTP statusové kódy:

• 200 — Úspešná požiadavka

• 201 — Objekt úspešne vytvorený

• 400 — Neplatné parametre

• 401 — Chyba autorizácie (neplatný API kľúč)

• 403 — Prístup zamietnutý

• 404 — Zdroj nebol nájdený

• 500 — Chyba servera

Tipy na používanie

• Vždy používajte novú verziu API pre nové integrácie

• Používajte Postman alebo curl na testovanie

• Rešpektujte limity rýchlosti aby ste sa vyhli zablokovaniu

• Aktualizujte integrácie, ktoré stále používajú starú dokumentáciu