API-Dokumentation

Verbinden und Arbeiten mit der Shifton-API

Die Shifton-API bietet Ihnen Zugriff auf alle wichtigen Funktionen der Plattform – von der Zeitplanverwaltung bis hin zu Integrationen mit externen HR, -Lohnabrechnung– und Analysesystemen.
Durch die Nutzung der API können Sie Prozesse automatisieren und Shifton mit den internen Diensten Ihres Unternehmens verbinden.

API-Dokumentation

Wir unterstützen zwei Versionen unserer Dokumentation:

• 📄 Alte Dokumentation – die vorherige Version der API-Referenz (wird weiterhin für bestehende Integrationen unterstützt):
  👉 https://api2.shifton.com/docs/?_gl=1*1p5sxoh*_gcl_au*NTAxMjY4NzA0LjE3NTcwNzUzMjAuMTI5NjMwODcwMS4xNzU4MjcxOTkzLjE3NTgyNzE5OTI.*_ga*NTE5MDI0OTM2LjE3NTcwNzUzMjA.*_ga_1M7TJQ7HY8*czE3NTg2MjA4MDUkbzU1JGcxJHQxNzU4NjIwOTE5JGo2MCRsMCRoNjU1OTcyMjMw#/en/v1/

• 🚀 Neue Dokumentation – die aktuelle Version der API mit einer aktualisierten Struktur und den neuesten Methoden:
  👉 https://api2.shifton.com/openapi/?_gl=1*1p5sxoh*_gcl_au*NTAxMjY4NzA0LjE3NTcwNzUzMjAuMTI5NjMwODcwMS4xNzU4MjcxOTkzLjE3NTgyNzE5OTI.*_ga*NTE5MDI0OTM2LjE3NTcwNzUzMjA.*_ga_1M7TJQ7HY8*czE3NTg2MjA4MDUkbzU1JGcxJHQxNzU4NjIwOTE5JGo2MCRsMCRoNjU1OTcyMjMw#/

Erste Schritte

API-Schlüssel erhalten

Generieren Sie in den Unternehmenseinstellungen auf der Shifton-Plattform einen API-Schlüssel.
Die Autorisierung erfolgt über den Header:

Ihre erste Anfrage stellen

Um beispielsweise eine Liste der Mitarbeiter abzurufen:

Beispielantwort:

Integrieren Sie die API in Ihre Arbeitsabläufe

• Automatisches Erstellen und Ändern von Schichten

• Verwalten von Urlaubs- und Krankheitsanträgen

• Exportieren von Daten in Lohnabrechnungssysteme

• Erstellen von benutzerdefinierten Dashboards und Berichten

Kern-API-Fähigkeiten

• Mitarbeiter – hinzufügen, bearbeiten und Rollen verwalten

• Zeitpläne – Schichten erstellen, anpassen, Arbeit planen

• Freizeit und Abwesenheiten – Urlaubs- und Krankheitsanfragen verwalten

• Berichterstattung – Zeit-, Lohn- und Anwesenheitsdaten exportieren

Fehlermeldungen

Die Shifton-API verwendet StandardHTTP-Statuscodes:

• 200 — Erfolgreiche Anfrage

• 201 — Objekt erfolgreich erstellt

• 400 — Ungültige Parameter

• 401 — Autorisierungsfehler (ungültiger API-Schlüssel)

• 403 — Zugriff verweigert

• 404 — Ressource nicht gefunden

• 500 — Serverfehler

Nutzungstipps

• Verwenden Sie immer dieneue API-Version für neue Integrationen

• Verwenden Sie Postman oder curl zum Testen

• Respektieren Sie Ratenlimits um nicht blockiert zu werden

• Aktualisieren Sie Integrationen, die noch auf die alte Dokumentation angewiesen sind