Die API Version 2 von Timebutler ist eine moderne Schnittstelle, die die vorherige Version vollständig ersetzt. Nutze sie, um Timebutler mit den Tools zu verbinden, auf die deine Organisation bereits setzt: Lohnabrechnungsanbieter, ERP-Systeme, HR-Software oder interne Workflow-Automatisierungen.
Die API Version 2 unterstützt unter anderem Folgendes:
-
Abrufen von Mitarbeitenden-Daten und Datensätzen aus der digitalen Personalakte
-
Abrufen von Abwesenheitseinträgen, Arbeitszeitaufzeichnungen und Urlaubsbeständen
-
Steuern der virtuellen Stempeluhr, Importieren von Arbeitszeiten oder Integrieren von Hardware-Terminals von Drittanbietern
-
Abfragen und Synchronisieren von Projekten, Aktivitäten und Schichtplanungsdaten
-
Exportieren von vorläufigen Gehaltsdaten
Dein:e Entwickler:in benötigt für den Einstieg eine Client-Anwendung und die technische Dokumentation der API. Die API folgt dem OpenAPI-Standard. Das bedeutet, dass die Integration unkompliziert ist und die meisten Entwickler innerhalb weniger Minuten startklar sind. Die technische Dokumentation der API deckt alle verfügbaren Endpunkte und Authentifizierungsdetails ab.
API aktivieren und Token verwalten
Admins können die API Version 2 jederzeit in den Kontoeinstellungen aktivieren oder deaktivieren. Der Zugriff auf sensible Bereiche – wie Gehaltsdaten oder die digitale Personalakte – kann unabhängig von der allgemeinen API-Aktivierung erlaubt oder eingeschränkt werden.
Im Gegensatz zur vorherigen Version verwendet die API Version 2 persönliche API-Token (Personal Tokens), die an einzelne Benutzerkonten gebunden sind, anstatt eines einzigen globalen Passworts. Dies gibt dir eine genauere Kontrolle darüber, wer auf die API zugreifen kann, und macht es einfach, den Zugriff für einen bestimmten Benutzer zu widerrufen, ohne andere zu beeinträchtigen.
So aktivierst du die API und erstellst einen Token:
-
Melde dich als Admin bei Timebutler an.
-
Gehe zu
Einstellungen>Dein Konto>API-Token>API-Token. -
Gib dem Token einen eindeutigen, aussagekräftigen Namen – zum Beispiel „ERP-Integration“.
-
Kopiere den Token sofort und bewahre es an einem sicheren Ort auf. Es wird nach dem Verlassen der Seite nicht mehr im Klartext angezeigt.
Jeder API-Aufruf wird revisionssicher protokolliert (Zugriffsprotokollierung). Als Administrator hast du einen vollständigen Überblick darüber, auf welche Daten wann zugegriffen wurde. Du oder der Benutzer können ein API-Token jederzeit widerrufen. Der Widerruf wird sofort wirksam – alle weiteren Anfragen mit diesem Token werden blockiert.
