timr REST API

Mit der timr REST API verbinden Sie Ihre bestehende Dateninfrastruktur – etwa Datenbank, Ticket-System, Issue-Tracking oder ERP-/CRM-Software – direkt mit timr. So halten Sie Ihre Daten automatisch synchron, ganz ohne manuelles Übertragen. Die Nutzung der API ist in allen kostenpflichtigen timr-Paketen enthalten.
 

Das bietet die REST API

Sie greifen unter anderem auf folgende Daten zu:

• Mitarbeiter, Teams und Arbeitszeitmodelle
• Arbeitszeiten und Projektzeiten
• Aufgaben inkl. Zuordnungen
• Fahrtenbuch (Fahrten, Fahrzeuge, Kategorien)

Eine vollständige Übersicht aller Endpunkte finden Sie in unserer Entwicklerdokumentation: https://developer.timr.com/

Die Basis-URL der API lautet https://api.timr.com/v1.
 

Tipp: Alle Releases und Änderungen an der API verfolgen Sie im Changelog: https://github.com/troii/timr-api/releases
 

Voraussetzungen

• Sie benötigen Administrator-Rechte in timr.
• Legen Sie vorab fest, welchen Grant-Type Sie verwenden: client_credentials (Maschine-zu-Maschine, ohne Benutzeranmeldung) oder authorization_code (mit Benutzeranmeldung). Mehr Infos zum Grant-Type finden Sie hier: Den richtigen Grant-Type wählen
• Für den Authorization Code Flow benötigen Sie mindestens eine absolute Redirect-URL.
   

So legen Sie Ihre API-Zugriffsdaten an

1. Öffnen Sie die timr-Webanwendung.
2. Navigieren Sie zu Verwaltung → Einstellungen → Integrationen.
3. Klicken Sie bei API Zugriffsdaten auf + Hinzufügen.
4. Vergeben Sie einen Namen und wählen Sie den Grant-Type aus.
5. Klicken Sie auf Speichern.

Sie erhalten daraufhin eine OAuth Client ID und ein OAuth Client Secret.

Hinweis: Bewahren Sie das Client Secret sicher auf – es handelt sich hierbei um sensible Daten Ihrer Mitarbeiter.

Die REST API authentifiziert über OAuth2. Ausführliche Informationen zu Grant Types, Scopes, Token-Endpoint und Beispiel-Requests finden Sie in der Doku OAuth2-Authentifizierung für die timr REST API.
 

SDKs und OpenAPI-Spezifikation

Für die REST API stehen Ihnen offizielle SDKs und die vollständige OpenAPI-Spezifikation zur Verfügung. Damit binden Sie timr schneller an Ihre eigenen Anwendungen an – mit fertigen Clients und passenden Datenmodellen.

Das timr API Repository ist öffentlich verfügbar: https://github.com/troii/timr-api

Es enthält:

• die OpenAPI-Spezifikation
• SDKs für Java (Spring RestClient und RestTemplate), Kotlin, .NET, TypeScript und Python

Installations- und Paketlinks finden Sie im Abschnitt Client SDKs des Repositories: https://github.com/troii/timr-api#client-sdks
 

Bitte kontaktieren Sie uns unter info@timr.com, wenn Sie Fragen zur API haben!

Weitere Integrationswege

Wenn Sie timr ohne eigene Programmierung anbinden möchten, können Sie timrLink nutzen – damit legen Sie per Konfiguration fest, welche Daten Ihrer Systeme nach welchem Zeitplan mit timr synchronisiert werden. Bitte kontaktieren Sie uns für detaillierte timrLink Preise.

Für bestehende Integrationen steht weiterhin die SOAP API zur Verfügung. Sie wird nicht mehr weiterentwickelt und ist im Artikel timr SOAP API (Legacy) beschrieben.