HTTP >Lancer une demande d’autorisation de clé API

Adobe Workfront plan*

Pro ou version ultérieure

Adobe Workfront license*

Plan, Work

Adobe Workfront Fusion license**

Exigences de licence actuelles : non Workfront Fusion conditions requises pour obtenir une licence.

Ou

Exigences de licence héritées : Workfront Fusion pour l’automatisation et l’intégration du travail

Produit

Conditions requises du produit actuel : si vous disposez de l’Select ou de l’Prime Adobe Workfront Planifiez, votre entreprise doit acheter Adobe Workfront Fusion ainsi que Adobe Workfront pour utiliser la fonctionnalité décrite dans cet article. Workfront Fusion est inclus dans l’Ultimate Workfront planifiez.

Ou

Exigences liées aux produits hérités : votre entreprise doit acheter Adobe Workfront Fusion ainsi que Adobe Workfront pour utiliser la fonctionnalité décrite dans cet article.

Credentials

Sélectionnez la clé contenant vos informations d’authentification de clé API. Pour ajouter une nouvelle clé, cliquez sur Ajouter et configurez les informations suivantes :

• Nom de la clé

  Saisissez un nom pour cet ensemble d’informations d’identification d’API.

• Key

  Saisissez la clé API.

• Emplacement de la clé de l’API

  Indiquez si la clé API doit être placée dans l’en-tête ou dans la requête de l’appel API.

• Nom du paramètre de clé API

  Saisissez le nom sous lequel l’appel API identifie la clé API, par exemple "apiKey" ou "X-API-Key". Vous trouverez ces informations dans la documentation du service Web auquel le module se connecte.

Évaluer tous les états comme des erreurs (sauf 2xx et 3xx)

Utilisez cette option pour configurer la gestion des erreurs.

Pour plus d’informations, voir Gestion des erreurs dans Adobe Workfront Fusion.

URL

Saisissez l’URL à laquelle vous souhaitez envoyer une requête, par exemple un point de terminaison API, un site web, etc.

Méthode

Sélectionnez la méthode de requête HTTP dont vous avez besoin pour configurer l’appel API. Pour plus d’informations, voir Méthodes de requête HTTP dans Adobe Workfront Fusion.

Headers

Ajoutez les en-têtes de la requête sous la forme d’un objet JSON standard. Par exemple, {"Content-type":"application/json"}

Query String

Entrez les paires clé-valeur de requête souhaitées.

Type de corps

Le corps HTTP est l’octet de données transmis dans un message de transaction HTTP immédiatement après les en-têtes s’il y a un élément à utiliser.

• Raw

  Le type de corps brut est généralement adapté à la plupart des requêtes de corps HTTP, même dans les cas où la documentation du développeur ne spécifie aucune donnée à envoyer.

  Spécifiez un formulaire d’analyse des données dans le champ Type de contenu .

  Malgré le type de contenu sélectionné, le module saisit les données dans n’importe quel format requis par la documentation destinée aux développeurs.

• Application/x-www-form-urlencoded

  Ce type de corps est destiné aux données POST qui utilisent application/x-www-form-urlencoded.

  Pour application/x-www-form-urlencoded, le corps du message HTTP envoyé au serveur est essentiellement une chaîne de requête. Les clés et les valeurs sont codées dans des paires clé-valeur séparées par & et avec un = entre la clé et la valeur.

  Pour les données binaires, utilisez multipart/form-data au lieu de .

  Exemple :

  Exemple du format de requête HTTP obtenu :

  field1=value1&field2=value2

• Multipart/form-data

  Multipart/form-data est une requête HTTP multipart utilisée pour envoyer des fichiers et des données. Il est généralement utilisé pour charger des fichiers sur le serveur.

  Ajoutez les champs à envoyer dans la requête. Chaque champ doit contenir une paire clé-valeur.

  • Texte

    Saisissez la clé et la valeur à envoyer dans le corps de la requête.

  • File

    Saisissez la clé et indiquez le fichier source à envoyer dans le corps de la requête.

    Mappez le fichier que vous souhaitez charger à partir du module précédent (par exemple HTTP >Obtenir un fichier ou Google Drive >Télécharger un fichier), ou saisissez manuellement le nom du fichier et les données du fichier.

Réponse d’analyse

Activez cette option pour analyser automatiquement les réponses et convertir les réponses JSON et XML afin que vous n’ayez pas à utiliser les modules JSON > Parse JSON ou XML > Parse XML.

Avant de pouvoir utiliser du contenu JSON ou XML analysé, exécutez le module une fois manuellement afin que le module puisse reconnaître le contenu de la réponse et vous permettre de le mapper dans les modules suivants.

Timeout

Spécifiez le délai d’expiration de la requête en secondes (1 à 300). La valeur par défaut est de 40 secondes.

Partage de cookies avec d’autres modules HTTP

Activez cette option pour partager les cookies du serveur avec tous les modules HTTP de votre scénario.

Certificat auto-signé

Téléchargez votre certificat si vous souhaitez utiliser TLS à l’aide de votre certificat auto-signé.

Rejeter les connexions qui utilisent des certificats non vérifiés (auto-signés)

Activez cette option pour rejeter les connexions qui utilisent des certificats TLS non vérifiés.

Suivre la redirection

Activez cette option pour suivre les redirections d’URL avec les réponses 3xx.

Suivre toutes les redirections

Activez cette option pour suivre les redirections d’URL avec tous les codes de réponse.

Désactivation de la sérialisation de plusieurs mêmes clés de chaîne de requête en tant que tableaux

Par défaut, Workfront Fusion gère plusieurs valeurs pour la même clé de paramètre de chaîne de requête d’URL que les tableaux. Par exemple : www.test.com?foo=bar&foo=baz sera converti en www.test.com?foo[0]=bar&foo[1]=baz. Activez cette option pour désactiver cette fonction.

Demander du contenu compressé

Activez cette option pour demander une version compressée du site web.

Ajoute un Accept-Encoding pour demander du contenu compressé.

Utiliser TLS Mutuel

Activez cette option pour utiliser le protocole TLS mutuel dans la requête HTTP.

Pour plus d’informations sur le protocole TLS mutuel, voir Utilisation de TLS mutuel dans les modules HTTP dans Adobe Workfront Fusion.