EN Support erhalten

API aktivieren

Timebutler bietet eine Schnittstelle (API) mit vielen Features, unter anderem:

  • Daten von Mitarbeitenden abrufen
  • Abwesenheitseinträge, Arbeitszeiten, Urlaubsansprüche und Arbeitstage von Mitarbeitenden abrufen
  • Stempeluhr für die Zeiterfassung steuern oder Arbeitszeiteinträge importieren
  • Hardware‑Zeiterfassungsterminals von Drittanbietern anbinden
  • Projekte und Kategorien für die Zeiterfassung herunterladen und ändern
  • Daten aus der Personalakte und Gehaltsdaten abfragen
  • und anderes

Damit kannst du Daten aus Timebutler automatisiert auslesen und sie zum Beispiel in Drittsoftware wie Datev, SAP oder in dein ERP importieren lassen, E‑Mails generieren, Benachrichtigungen an Mitarbeitende verschicken usw. Um die Schnittstelle abzufragen, brauchst du ein Programm, das die Schnittstelle aufruft. Eine erfahrene Entwickler:in kann in wenigen Minuten ein Programm erstellen, das die standardisierte Timebutler‑Schnittstelle abfragt.

Als Admin kannst du die Timebutler Schnittstelle aktivieren oder deaktivieren. Du kannst die Schnittstelle für die Abfrage von Personalakten‑ und Gehaltsdaten separat aktivieren oder deaktivieren und unabhängig davon die Schnittstelle für alle anderen Daten aktivieren. Für den Zugriff brauchst du einen individuellen API‑Token. Ein:e Admin‑Nutzer:in kann den API‑Token erzeugen. Es gibt einen API‑Token für die Abfrage der Personalakten‑ und Gehaltsdaten und einen API‑Token für die restlichen API‑Endpunkte. So kannst du die Zugriffe auf beide Datenarten getrennt verwalten und separat vergeben.

Schnittstelle aktivieren oder deaktivieren

Um die Schnittstelle zu aktivieren oder zu deaktivieren, melde dich als Admin bei Timebutler an und klicke dann auf einer beliebigen Seite im Timebutler unten im Footer‑Bereich auf den Link “Schnittstelle (API)”. Dort kannst du die zwei Schnittstellen aktivieren oder deaktivieren; dort werden auch die zwei API‑Token angezeigt.

Dein:e Entwickler:in benötigt diese zwei API‑Token, um die Schnittstelle abfragen zu können. Außerdem braucht dein:e Entwickler:in die technische Dokumentation der API.

Als Admin kannst du jederzeit einen neuen API‑Token erzeugen. Damit wird der alte API‑Token ungültig, sodass mit dem alten API‑Token kein Zugriff auf die Schnittstelle und Daten mehr möglich ist.

Screenshot: API aktivieren