Dokumentacja API

Łączenie się i Praca z API Shifton

API Shifton daje dostęp do wszystkich kluczowych funkcji platformy — od zarządzania harmonogramem po integracje z zewnętrznymi systemami HR, płac i systemami analitycznymi.
Korzystając z API, możesz automatyzować procesy i łączyć Shifton z wewnętrznymi usługami Twojej firmy.

Dokumentacja API

Obsługujemy dwie wersje naszej dokumentacji:

• 📄 Stara Dokumentacja — poprzednia wersja odniesienia dla API (nadal wspierana dla istniejących integracji):
  👉 https://api2.shifton.com/docs/?_gl=1*1p5sxoh*_gcl_au*NTAxMjY4NzA0LjE3NTcwNzUzMjAuMTI5NjMwODcwMS4xNzU4MjcxOTkzLjE3NTgyNzE5OTI.*_ga*NTE5MDI0OTM2LjE3NTcwNzUzMjA.*_ga_1M7TJQ7HY8*czE3NTg2MjA4MDUkbzU1JGcxJHQxNzU4NjIwOTE5JGo2MCRsMCRoNjU1OTcyMjMw#/en/v1/

• 🚀 Nowa Dokumentacja — obecna wersja API z zaktualizowaną strukturą i najnowszymi metodami:
  👉 https://api2.shifton.com/openapi/?_gl=1*1p5sxoh*_gcl_au*NTAxMjY4NzA0LjE3NTcwNzUzMjAuMTI5NjMwODcwMS4xNzU4MjcxOTkzLjE3NTgyNzE5OTI.*_ga*NTE5MDI0OTM2LjE3NTcwNzUzMjA.*_ga_1M7TJQ7HY8*czE3NTg2MjA4MDUkbzU1JGcxJHQxNzU4NjIwOTE5JGo2MCRsMCRoNjU1OTcyMjMw#/

Pierwsze Kroki

Uzyskaj Klucz API

W ustawieniach firmy na platformie Shifton wygeneruj klucz API.
Autoryzacja odbywa się poprzez nagłówek:

Złóż Pierwsze Żądanie

Na przykład, aby pobrać listę pracowników:

Przykładowa odpowiedź:

Zintegruj API z Twoimi Procedurami

• Automatycznie twórz i modyfikuj zmiany

• Zarządzaj wnioskami o urlop i zwolnienia chorobowe

• Eksportuj dane do systemów płac

• Buduj niestandardowe pulpity i raporty

Główne możliwości API

• Pracownicy – dodawanie, edytowanie i zarządzanie rolami

• Harmonogramy – tworzenie, dostosowywanie zmian, planowanie pracy

• Urlopy i nieobecności – zarządzanie wnioskami o urlop i zwolnienia lekarskie

• Raportowanie – eksport danych dotyczących czasu, wynagrodzeń i obecności

Kody błędów

API Shifton używa standardowych kodów statusu HTTP:

• 200 — Żądanie zakończone sukcesem

• 201 — Obiekt pomyślnie utworzony

• 400 — Niepoprawne parametry

• 401 — Błąd autoryzacji (nieprawidłowy klucz API)

• 403 — Dostęp zabroniony

• 404 — Nie znaleziono zasobu

• 500 — Błąd serwera

Wskazówki dotyczące użytkowania

• Zawsze używaj nowej wersji API do nowych integracji

• Użyj Postman lub curl do testowania

• Przestrzegaj limitów szybkości aby uniknąć zablokowania

• Zaktualizuj integracje, które nadal opierają się na starej dokumentacji