Übersicht

Willkommen bei der Workfront Proof-API

Die Workfront Proof-API ist ein einfacher HTTP-Dienst, der mit SSL gesichert wird. Die API soll Ihnen alle Funktionen zur Verfügung stellen, die in unserer eigenen Anwendung verwendet werden.

Unterstützte Formate

Die öffentliche Benutzeroberfläche ist SOAP 1.1 mit WSDL-Unterstützung kompatibel. Alle Anfragen werden daher mithilfe von XML über HTTPS ausgeführt.

API-Versionierung

Um die Kompatibilität mit der vorhandenen Client-Integration zu gewährleisten, haben wir die API-Versionierung ab unserer Version 12.1 eingeführt. Lesen Sie hierzu die  Seite API-Aktualisierungen für weitere Informationen. Wenn eine Methode oder ein Parameter keine Versionsinformationen enthält, bedeutet dies, dass Sie dies als Teil unserer Standard-API finden, finden Sie im Abschnitt "Erste Schritte mit der API"unten.

Erste Schritte mit der API

Der API-Einstiegspunkt:

https://soap.proofhq.com/soap (Bitte beachten Sie die Verwendung von HTTPS)

Die WSDL finden Sie hier:

https://soap.proofhq.com/soap?wsdl

Für jede API-Anfrage ist ein Sitzungsschlüssel erforderlich. Dieser Sitzungsschlüssel identifiziert den Workfront Proof-Benutzer, der die Aktion(en) ausführt. Er wird abgerufen, indem die Methode doLogin() aufgerufen und die E-Mail-Adresse und das Kennwort des Benutzers übergeben werden. Die Methode doLogin() muss nur einmal vor einer Sequenz von API-Anfragen aufgerufen werden. Der Sitzungsschlüssel bleibt für einen kurzen Zeitraum aktiv und wird bei jedem Methodenaufruf erneuert.  Wir werden in Kürze Unterstützung für Token-basierte Authentifizierung hinzufügen.

Alle Anforderungen verwenden das folgende Umschlag-, Header- und Textformat:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:proofhqapi">`
   <soapenv:Header/>
   <soapenv:Body>
       ... API function and data inserted here ...
    </soapenv:Body>
    </soapenv:Envelope>