Dokumentace API

Připojení a práce s API Shifton

API Shifton vám poskytuje přístup ke všem klíčovým funkcím platformy – od správy rozvrhů po integrace s externími HR, mzdovými systémy a analytickými systémy..
Použitím API můžete automatizovat procesy a propojit Shifton s interními službami vaší společnosti.

Dokumentace API

Podporujeme dvě verze naší dokumentace:

• 📄 Stará dokumentace — předchozí verze referenčního dokumentu API (stále podporována pro stávající integrace):
  👉 https://api2.shifton.com/docs/?_gl=1*1p5sxoh*_gcl_au*NTAxMjY4NzA0LjE3NTcwNzUzMjAuMTI5NjMwODcwMS4xNzU4MjcxOTkzLjE3NTgyNzE5OTI.*_ga*NTE5MDI0OTM2LjE3NTcwNzUzMjA.*_ga_1M7TJQ7HY8*czE3NTg2MjA4MDUkbzU1JGcxJHQxNzU4NjIwOTE5JGo2MCRsMCRoNjU1OTcyMjMw#/en/v1/

• 🚀 Nová dokumentace — aktuální verze API s aktualizovanou strukturou a nejnovějšími metodami:
  👉 https://api2.shifton.com/openapi/?_gl=1*1p5sxoh*_gcl_au*NTAxMjY4NzA0LjE3NTcwNzUzMjAuMTI5NjMwODcwMS4xNzU4MjcxOTkzLjE3NTgyNzE5OTI.*_ga*NTE5MDI0OTM2LjE3NTcwNzUzMjA.*_ga_1M7TJQ7HY8*czE3NTg2MjA4MDUkbzU1JGcxJHQxNzU4NjIwOTE5JGo2MCRsMCRoNjU1OTcyMjMw#/

Jak začít

Získejte klíč API

Ve vašem nastavení společnosti na platformě Shifton vygenerujte klíč API..
Autorizace se provádí prostřednictvím hlavičky:

Pošlete svůj první požadavek

Například pro získání seznamu zaměstnanců:

Příklad odpovědi:

Integrace API do vašich pracovních postupů

• Automaticky vytvářejte a upravujte směny

• Spravujte žádosti o dovolenou a nemocenskou

• Exportujte data do mzdových systémů

• Vytvářejte vlastní dashboardy a reporty

Hlavní schopnosti API

• Zaměstnanci – přidávat, upravovat a spravovat role

• Plány – vytvářet, upravovat směny, plánovat práci

• Volno a absence – spravovat žádosti o dovolenou a nemocenskou

• Reporty – exportovat data o čase, mzdách a docházce

Chybové kódy

Shifton API využívá standardní HTTP stavové kódy:

• 200 — Úspěšný požadavek

• 201 — Objekt úspěšně vytvořen

• 400 — Neplatné parametry

• 401 — Chyba autorizace (neplatný API klíč)

• 403 — Přístup odepřen

• 404 — Zdroj nebyl nalezen

• 500 — Chyba serveru

Tipy pro použití

• Vždy používejte novou verzi API pro nové integrace

• Použijte Postman nebo curl k testování

• Dodržujte limit rychlosti abyste zabránili zablokování

• Aktualizujte integrace, které stále spoléhají na starou dokumentaci