timr API Schnittstelle

Wenn Sie Ihre bestehende Dateninfrastruktur (Datenbank, Ticket-System, Issue Tracking, ERP/CRM-Software, ...) mit timr synchronisieren möchten, können Sie das über unsere API Schnittstelle machen. Die Nutzung der API ist in allen kostenpflichtigen timr-Paketen enthalten.

REST API

Mit der timr REST API binden Sie timr an Ihre bestehenden Systeme an und halten Ihre Daten automatisch synchron – ganz ohne manuelles Übertragen.
 

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.
 

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 wird nur einmal angezeigt.

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.

timrLink

Neben der API bieten wir auch timrLink an. Damit können Sie mit einer einfachen Konfiguration und ohne die API selbst zu implementieren, definieren, welche Entitäten Ihrer Infrastruktur mit timr nach welchem Zeitplan synchronisiert werden sollen. Bitte kontaktieren Sie uns für detaillierte timrLink Preise.

SOAP API

Hinweis: Die SOAP API bleibt für bestehende Integrationen weiterhin nutzbar. Für neue Integrationen empfehlen wir die REST API (siehe oben). Die SOAP API wird künftig als Legacy geführt und nicht mehr weiterentwickelt.

Hinweis: Die Token-Erstellung für die SOAP API erfolgt aktuell direkt über unser Team. Bitte kontaktieren Sie uns dazu unter info@timr.com.
 

WSDL herunterladen

Die timr API WSDL können Sie hier herunterladen: https://timrsync.timr.com/timr/timrsync.wsdl
 

Token erstellen

1. Navigieren Sie zu Verwaltung → Einstellungen.
2. Generieren Sie im Reiter Integrationen im Feld SOAP API ein Token.

Dieses Token dient als Passwort für die Verbindung zur Webservice-API.

Hinweis: Ein normales Benutzerkonto kann für die Verbindung nicht verwendet werden.
 

Anmeldedaten

• Benutzername: Ihr Identifier (= Ihre timr-URL – bei mustermann.timr.com lautet der Identifier mustermann)
• Passwort: Ihr Authentifizierungstoken

Anfragen senden

Senden Sie Ihre Anfragen als POST an https://timrsync.timr.com/timr/timrsync und verwenden Sie dabei HTTP-Basic-Authentifizierung (Identifier als Benutzername, Token als Passwort).

Beispiel-Request – Benutzer abrufen:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tim="http://timr.com/timrsync">
   <soapenv:Header/>
   <soapenv:Body>
      <tim:GetUsersRequest/>
   </soapenv:Body>
</soapenv:Envelope>

Tools zum Testen

Zum Testen der API und zum Erstellen Ihres Clients empfehlen wir soapUI oder Visual Studio .NET.
 

Code-Beispiele

Wir stellen Beispiel-Implementierungen für Java und .NET bereit:

• Java: https://github.com/troii/timrsyncclient – Beispiel mit spring-ws und JAXB-Marshalling, das die Methode getTasks aufruft (ruft alle in Ihrem timr-Konto angelegten Aufgaben ab).
• .NET: https://github.com/troii/timrsync-dotnet-testclient

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