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 kostenlos.

REST API

Derzeit arbeiten wir an einer neuen REST API die auch bereits als Beta für Kunden verfügbar ist. Für weitere Informationen zur REST API kontaktieren Sie uns bitte im Support.

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

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

Was Sie tun müssen: Bitte gehen Sie zu Verwaltung/Einstellungen. Dort gibt es ein Feld "timr API", in dem Sie ein Token generieren müssen. Dieses Token ist das Passwort für die Verbindung zum Webservice API. Sie können KEIN "Benutzerkonto" für die Verbindung über die Webservice-API verwenden.

Die Anmeldedaten für die Verbindung mit der Webservice-API lauten:

Benutzername=[Identifier]

Passwort=[Authentifizierungstoken].

Identifier=Ihre timr URL. Beispiel: mustermann.timr.com, Identifier=mustermann

Eine Beispielanfrage die an die timrsync-Schnittstelle gesendet wird um die Benutzer abzurufen, sollte wie folgt aussehen:

<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>

Wenn Sie diese XML-Daten als POST-Anfrage an https://timrsync.timr.com/timr/timrsync senden und die grundlegende HTTP-Authentifizierung verwenden, indem Sie Ihren Client-Identifier (=timr URL) als Benutzernamen und Ihr API-Token als Passwort angeben, sollten Sie eine gültige Antwort erhalten.

Wir empfehlen ein Tool wie soapUI (http://www.soapui.org/) oder Visual Studio .NET zu verwenden, um die Webservice-API zu testen und Ihren Client zu erstellen.

Beispiele:

Wir bieten Beispiele und API-Demo-Implementierungen für .NET und Java.

Java: Der Quellcode eines Java-Clients für unsere SOAP-Webservice-API ist auf github zu finden. Dort finden Sie ein Beispiel für die Verwendung in Ihren Java-Anwendungen: https://github.com/troii/timrsyncclient. Das Beispiel verwendet spring-ws und jaxb marshalling, um die getTasks-Methode aufzurufen, die alle Aufgaben abruft, die in Ihrem timr-Konto erstellt wurden.

.NET: Das Beispielprojekt finden Sie hier https://github.com/troii/timrsync-dotnet-testclient

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