Vue d’ensemble

Présentation de l’API Workfront Proof

L’API Workfront Proof est un service HTTP simple sécurisé à l’aide de SSL. L’API vise à vous fournir toutes les fonctionnalités utilisées dans notre propre application.

Formats pris en charge

L’interface publique est conforme à la norme SOAP 1.1 avec la prise en charge WSDL.Toutes les requêtes sont donc exécutées à l’aide de XML sur HTTPS.

Contrôle de version des API

Afin de préserver la compatibilité avec les intégrations client existantes, nous avons introduit le contrôle de version des API à partir de notre version 12.1. Veuillez consulter la page Mises à jour des API pour plus d’informations. Si une méthode ou un paramètre ne contient aucune information de version, cela signifie que vous trouverez cela dans notre API standard. Reportez-vous à la section « Commencer avec l’API » ci-dessous.

Commencer avec l’API

Point d’entrée de l’API :

https://soap.proofhq.com/soap (notez l’utilisation de HTTPS)

Le fichier WSDL se trouve ici :

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

Chaque demande d’API nécessite une clé de session. Cette clé de session identifie l’utilisateur ou utilisatrice de Workfront Proof effectuant la ou les actions. Elle est obtenue en appelant la méthode doLogin() et en transmettant l’adresse e-mail et le mot de passe de la personne. La méthode doLogin() ne doit être appelée qu’une seule fois avant une séquence de demandes d’API. La clé de session reste active pendant une courte période et est renouvelée à chaque appel de méthode.Nous ajouterons très bientôt la prise en charge de l’authentification basée sur les jetons.

Toutes les requêtes utilisent le format d’enveloppe, d’en-tête et de corps suivant :

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