Übersicht

Willkommen bei der Workfront Proof-API

Die Workfront Proof-API ist ein einfacher HTTP-Service, der mit SSL gesichert wird. Die API zielt darauf ab, Ihnen alle Funktionen bereitzustellen, die in unserer eigenen Anwendung verwendet werden.

Unterstützte Formate

Die öffentliche Benutzeroberfläche ist mit SOAP 1.1 kompatibel und unterstützt WSDL. Alle Anfragen werden daher mit XML über HTTPS ausgeführt.

API-Versionierung

Um die Kompatibilität mit den vorhandenen Client-Integrationen zu wahren, haben wir die API-Versionierung ab unserer Version 12.1 eingeführt. Weitere Informationen finden Sie auf ​ Seite ​API-Updates“. Wenn eine Methode oder ein Parameter keine Versionsinformationen enthält, bedeutet dies, dass Sie dies als Teil unserer Standard-API finden, siehe den 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

Jede API-Anfrage erfordert einen Sitzungsschlüssel. Dieser Sitzungsschlüssel identifiziert den Workfront Proof-Benutzer, der die Aktion(en) ausführt, und wird durch Aufruf der doLogin()-Methode und Übergabe der E-Mail-Adresse und des Passworts des Benutzers abgerufen. Die Methode doLogin() muss nur einmal vor einer Sequenz von API-Anfragen aufgerufen werden. Der Sitzungsschlüssel bleibt kurze Zeit aktiv und wird bei jedem Methodenaufruf erneuert. Wir werden sehr bald Unterstützung für Token-basierte Authentifizierung hinzufügen.

Alle Anfragen verwenden das folgende Umschlag-, Kopfzeilen- und Textkörperformat:

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