timr SOAP API (Legacy)

Dieser Artikel richtet sich an Kundinnen und Kunden mit einer bestehenden SOAP-Integration. Die SOAP API bleibt für bestehende Integrationen weiterhin nutzbar, wird aber als Legacy geführt und nicht mehr weiterentwickelt.

Hinweis: Für neue Integrationen empfehlen wir die REST API. Details dazu finden Sie im Artikel timr API Schnittstelle.
 

WSDL herunterladen

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

Token erstellen

Für die Token-Erstellung benötigen Sie Administrator-Rechte in timr.

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

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 SOAP API haben.