Demande HTTP (HTTP Request)

UiPath.Web.Activities.Http.NetHttpClient

Important : cette activité est disponible dans les versions du package WebAPI à partir de 2.0.0-preview et 2.3.0 GA. Pour l'expérience héritée, utilisez la précédente activité Demande HTTP (héritage) incluse dans les versions WebAPI antérieures à 2.0.0-preview.

Description

Utilisez l'activité Requête HTTP (HTTP Request) dans WebAPI 2.0.0-preview pour automatiser et simplifier la réalisation de requêtes vers les serveurs Web ou les API. L'activité Requête HTTP (HTTP Request) vous aide à :

• Envoyez et recevez des données en toute sécurité entre les systèmes.
• Téléchargez des fichiers et des données à l’aide de formulaires.
• Gérez les erreurs correctement en recommençant les requêtes en cas de problème.
• Connectez-vous en toute sécurité à l'aide de SSL pour protéger les données.
• Gérez automatiquement les cookies et les proxys pour gérer les sessions et les restrictions réseau.

Compatibilité du projet

Windows | Multiplateforme

Windows, configuration multiplate-forme

Propriétés du corps de l'activité
Méthode de demande *	Sélectionnez la façon dont votre requête HTTP doit interagir avec le serveur : OBTENIR : récupère les données sans les modifier. POST : envoie des données au serveur, généralement pour créer ou mettre à jour une ressource. PUT : Met à jour une ressource existante. DELETE : Supprime une ressource spécifiée du serveur. HEAD—Semblable à GET, mais récupère uniquement les en-têtes sans le contenu du corps. OPTIONS : fournit des informations sur les options de communication disponibles sur le serveur. PATCH : Met à jour partiellement une ressource existante. Trace (Trace)— Utilisé à des fins de diagnostic, faisant écho à la requête reçue vers le client.
URL de la demande *	Indiquez l'adresse Web du serveur auquel vous souhaitez envoyer votre demande. Par exemple : https://store.example.com/search.
Paramètres	Ajoutez à votre demande des détails spécifiques au serveur sous forme de paires clé-valeur. Par exemple, query: "laptop", sortBy: "price".
En-têtes	Ajoutez des instructions spécifiques au serveur ou des détails d'authentification sous forme de paires clé-valeur. Par exemple, Authorization: "Bearer <your_access_token>", Accept: "application/json".
Type de corps de la requête *	Sélectionnez le type de contenu que vous souhaitez envoyer au serveur : Aucun : n'envoie aucune donnée, généralement pour les méthodes de récupération. Texte (Text) : envoie des données en texte brut, généralement pour les méthodes POST et PUT. Une fois sélectionné, les champs suivants s'affichent : Type de contenu du texte : sélectionnez le format du texte que vous souhaitez envoyer dans votre requête HTTP, afin que le serveur sache comment l'interpréter : text/plain— Texte brut régulier. text/html—Texte au format HTML. text/css— Texte formaté CSS. text/csv— Données structurées au format CSV. text/xml— Texte au format XML, destiné à être lu par les humains. application/xml—Texte au format XML, destiné aux applications à traiter. application/json— Texte au format JSON. Texte (Text) : écrivez le texte ou les données que vous souhaitez envoyer dans votre demande. Encodage de texte (Text encoding ) — Sélectionnez le format d'encodage pour la charge utile de texte (Unicode, ASCII ou ISO). Cela garantit que le serveur de réception lit avec précision votre charge utile de texte. URL de formulaire codé (Form URL coded) : envoie des données formatées sous forme de simples paires clé-valeur. Une fois sélectionnée, le champ suivant s'affiche : Données de formulaire codées en URL (Url-encoded form data) : fournissez les paires clé-valeur. Par exemple, searchQuery: "Smartphone", brand: "XYZ", inStock: "true". Données de formulaire multipart : envoie des fichiers ou des données complexes. Utilisez-le lorsque vous devez combiner différents types de données dans votre demande. Une fois sélectionné, les champs suivants s'affichent : Fichiers de ressources (Resource files) : indiquez le nom des fichiers stockés dans votre projet en tant qu'objets IResource. Fichiers locaux : indiquez le chemin d'accès à un fichier situé sur votre appareil. Par exemple, "C:/Images/product-photo.jpg". Parties de données de formulaire : fournir une collection de FormDataPart Objets : TextFormDataPart : pour les charges utiles de chaîne, telles que JSON ou le texte brut. BinaryFormDataPart —Pour les tableaux d'octets bruts. FileFormDataPart :pour les flux de fichier basés sur un chemin donné. Par exemple, une collection FormDataPart utilisant l' éditeur d'expressions: #VB New List(Of FormDataPart) From { New TextFormDataPart("{""jsonKey"":""jsonValue""}", "textPart", Encoding.UTF8, "application/json"), New BinaryFormDataPart(Encoding.UTF8.GetBytes("binaryContent"), "binaryPart", "application/octet-stream"), New FileFormDataPart("C:/Work/testfile.txt", "filePart", "text/plain") } Chaque type FormDataPart est livré avec plusieurs constructeurs, vous permettant de bénéficier des valeurs par défaut couramment utilisées. L'activité attribue automatiquement l'en-tête Content-Type correct pour chaque FileFormDataPart. Vous pouvez remplacer cet en-tête manuellement. Pour les listes de fichiers, vous ne pouvez pas remplacer l'en-tête automatiquement attribué. Pour les listes de fichiers de ressources, l'activité utilise le type MIME disponible. Données de formulaire codées en URL : fournissez des paires clé-valeur simples. Binaire— Envoie les données brutes. Une fois sélectionnée, le champ suivant s'affiche : Charge utile binaire (Binary Payload ) : fournissez la charge utile des données brutes, comme les images, les vidéos, les fichiers volumineux ou les données en continu. Par exemple, l'envoi d'une image en binaire : File.ReadAllBytes("C:/Images/product-image.jpg") Flux : envoie des données en continu, telles que le téléchargement d'un fichier volumineux (audit ou vidéo), lorsque les données ne peuvent pas être entièrement chargées dans la mémoire en même temps. Une fois sélectionnée, le champ suivant s'affiche : Fichier local : Indiquez le chemin d'accès au fichier volumineux, par exemple : File.OpenRead("C:/Videos/large-video.mp4") L'activité attribue automatiquement l'en-tête Content-Type correct au fichier téléchargé. Vous pouvez remplacer cet en-tête manuellement.

Panneau propriétés
Temps de conception et d'importation cURL Cette section vous aide à configurer l'activité via les extraits de code cURL et à effectuer des tests de la requête en phase de conception.	Texte de commande cURL : champ de texte multiligne au moment de la conception où une commande cURL complète peut être collée. Prend en charge les styles `cm et bash. Bouton d'importation cURL :bouton d'action qui déclenche immédiatement l'analyse/l'importation du texte de commande cURL actuel dans l'activité (méthode, URL, en-têtes, corps, authentification, fichiers). Bouton de demande de test :bouton d'action qui exécute la requête configurée au moment de la conception. Lors de l'exécution, il bascule sur Annuler. Une fois terminée ou annulée, elle revient à Test et met à jour le champ Rapport avec une réponse ou une erreur formatée. Rapport :zone de texte multiligne utilisée pour afficher le résultat de la dernière importation cURL ou de l'exécution du test en phase de conception (récapitulatif des réussites, détails du mappage, avertissements ou erreurs).
Options du client Cette section vous aide à définir les paramètres liés à la connexion.	Désactiver la vérification SSL (Disable SSL verification ) : ignore les vérifications de la sécurité SSL. Utile pour les tests (Vrai), non recommandé pour la production (Faux, par défaut). Protocole TLS (TLS Protocol ) : sélectionne le protocole TLS pour les connexions sécurisées. Les options disponibles sont Automatique (par défaut), TLS 1.2 et TLS 1.3. Activer les cookies : active la gestion automatique des cookies par défaut (Vrai). Définissez ce paramètre sur « False » pour désactiver la gestion automatique des cookies. Certificat client (Client certificate ) : indique le chemin d'accès au certificat client pour l'authentification avec des API sécurisées. Par exemple, "C:/certificates/client-cert.pfx". Mot de passe sécurisé du certificat client (Client certificate secure password ) : stocke le mot de passe sécurisé pour le certificat client fourni. Par exemple, "certPassword". Basculez entre les mots de passe simples et sécurisés en sélectionnant l'icône plus et en choisissant l'option souhaitée : Utiliser la chaîne simple (Use simples string) et Utiliser la chaîne sécurisée (Use secure string). Configuration du proxy : configure des proxys personnalisés, y compris la prise en charge des listes d'authentification et de contournement. Par exemple, "http://proxy.example.com:8080".
Authentification Cette section vous aide à définir comment l'activité s'authentifie auprès du serveur.	Authentification : sélectionnez la méthode d'authentification. Les options disponibles sont les suivantes : Aucune authentification (No authentication ) : le serveur ne nécessite pas de validation de l'utilisateur pour accepter votre requête. Authentification de base : fournit la validation de l'utilisateur au serveur de réception via le nom d'utilisateur et le mot de passe sécurisé. Basculez entre les mots de passe simples et sécurisés en sélectionnant l'icône plus et en choisissant l'option souhaitée : Utiliser la chaîne simple (Use simples string) et Utiliser la chaîne sécurisée (Use secure string). Jeton du porteur (Bearer token ) : fournit la validation de l'utilisateur au serveur de réception via un jeton de porteur unique généré après la connexion. Authentification négociée : utilisez le schéma HTTP Negotiate pendant le runtime pour sélectionner Kerberos ou NTLM (et éventuellement Digest) en fonction des défis du serveur. Lorsque l' Authentification est définie sur Authentification négociée et Utiliser les informations d'identification du système d'exploitation = Vrai, le contexte utilisateur actuel du système d'exploitation est utilisé (jeton d'ouverture de la session Windows ; sur Linux/macOS, un ticket Kerberos existant, par exemple de kinit). Définissez Utiliser les informations d’identification du système d’exploitation sur Faux pour activer le champ Informations d’identification personnalisées ; indiquez un identifiant réseau (domaine/nom d'utilisateur/mot de passe ou mot de passe sécurisé).
Options de la requête Cette section vous aide à définir le comportement de la requête.	Cookies supplémentaires : spécifiez manuellement les cookies supplémentaires sous forme de paires clé-valeur. Délai d’expiration de la demande : spécifiez le temps d’attente maximal, en millisecondes, avant l’abandon de la demande. La valeur par défaut est de 10 000 millisecondes (10 secondes). Continuer en cas d'erreur (Continue On Error) : décidez si l'automatisation doit se poursuivre même lorsque l'activité génère une erreur (Vrai(True), option par défaut). Pour arrêter l'automatisation lorsqu'une erreur se produit, utilisez Faux (False). Suivre les redirections (Follow redirects) : décidez si votre demande doit automatiquement suivre les redirections d'URL fournies par le serveur (Vrai(True), option par défaut). Pour ignorer les redirections et utiliser la réponse initiale, utilisez Faux (False). Nombre maximal de redirections : spécifiez le nombre de redirections automatiques que vous souhaitez suivre avant de vous arrêter. La valeur par défaut est 3.
Stratégie de nouvelle tentative Cette section vous aide à définir le mécanisme de nouvelle tentative en cas d'échec de la demande.	Retenter le type de stratégie (Retry policy type) : spécifiez la méthode de nouvelle tentative des demandes. Les options disponibles sont les suivantes : Aucune nouvelle tentative (No retry ) : votre demande n'appelle le serveur qu'une seule fois. En cas d'échec, aucune autre tentative n'a lieu. Nouvelle tentative de base (Basic retry ) : réessaye la requête après des échecs en utilisant un délai fixe. Nombre de nouvelles tentatives (Retry count) : spécifiez le nombre de nouvelles tentatives. La valeur par défaut est 3. Délai : spécifiez le temps fixe entre les nouvelles tentatives en millisecondes. La valeur par défaut est de 500 millisecondes (0,5 seconde). Utiliser l'en-tête Réessayer-Après : décidez si la requête doit utiliser l'en-tête Réessayer-Après recommandé par le serveur (Vrai, option par défaut). Pour ignorer la valeur de l'en-tête Réessayer - Après (Retry-After) , utilisez Faux (False). Limite de délai : spécifiez le délai maximal autorisé entre les nouvelles tentatives de nouvelle tentative , en millisecondes. La valeur par défaut est de 30 000 millisecondes (30 secondes). Codes de nouvelle tentative (Retry status codes) : spécifiez les codes de statut qui doivent déclencher de nouvelles tentatives. Retour exponentiel (Exponential backoff ) : Nouvelles tentatives avec des délais croissants entre chaque tentative. Nombre de nouvelles tentatives (Retry count) : spécifiez le nombre de nouvelles tentatives. La valeur par défaut est 3. Délai initial (Inital Delay ) : spécifiez le délai avant la première nouvelle tentative, en millisecondes. La valeur par défaut est de 500 millisecondes (0,5 seconde). Multiplicateur : spécifiez le nombre utilisé pour augmenter le délai après l'échec de chaque demande. La valeur par défaut est 2, ce qui double le délai à chaque fois. Utiliser jitter (Use jitter) — Pour les délais, décidez si vous souhaitez ajouter un décalage aléatoire entre 0 et 100 millisecondes pour éviter les nouvelles tentatives synchronisées (Vrai(True), par défaut). Utiliser l'en-tête Réessayer-Après : décidez si la requête doit utiliser l'en-tête Réessayer-Après recommandé par le serveur (Vrai, option par défaut). Pour ignorer la valeur de l'en-tête Réessayer - Après (Retry-After) , utilisez Faux (False). Limite de délai : spécifiez le délai maximal autorisé entre les nouvelles tentatives de nouvelle tentative , en millisecondes. La valeur par défaut est de 30 000 millisecondes (30 secondes). Codes de nouvelle tentative (Retry status codes) : spécifiez les codes de statut qui doivent déclencher de nouvelles tentatives.
Options de réponse Cette section vous aide à personnaliser la façon dont la réponse sera renvoyée par le serveur.	Enregistrez toujours la réponse en tant que fichier : forcez l’écriture du corps de la réponse sur le disque même lorsqu’un nom de fichier en pièce jointe n’est pas déduit. Activer les informations de débogage : activer la capture de débogage étendue (métadonnées brutes des demandes/réponses, instantané des en-têtes, calendrier, détails des nouvelles tentatives) et générer une sortie vers l'objet de réponse, ou bien pendant les tests de conception. Nom du fichier de sortie : remplacez le nom de fichier fourni par le serveur (par exemple, dans Content-Disposition ). Output file target folder : contrôlez le dossier de destination des fichiers de réponse enregistrés. Si le fichier existe déjà : définissez la stratégie de collision lorsqu'un fichier avec le nom résolu existe déjà dans le dossier cible. Options : Renommer automatiquement : ajoutez un suffixe incrémentiel (_1, _2, .. pour produire un nom de fichier unique. Replace : écrase le fichier existant. Arrêter et ignorer— Abandonnant l'opération d'enregistrement (et le workflow si l'exception ne soit pas gérée) en laissant le fichier existant intact.
Sortie Cette section vous aide à capturer et à stocker la réponse renvoyée par le serveur.	Contenu de la réponse : Capture la réponse du serveur et la stocke dans une variable, pour un traitement futur. Il comprend : CodeStatut ( StatusCode ) : code de statut de la réponse HTTP. ContenuTexte : la réponse sous forme de texte brut (si disponible). ContenuBinaire : Données de réponse brutes pour le contenu non textuel. Fichier— Réponse enregistrée sous forme de fichier (ILocalResource) dans votre dossier Téléchargements. Le nom de fichier provient des en-têtes de réponse ou est généré automatiquement pour éviter d'écraser des fichiers. En-têtes— Tous les en-têtes de réponse HTTP. En-têtes de contenu (ContentHeaders ) - En-têtes spécifiquement liés au contenu de la réponse. Par exemple, Content-Type et Content-Length. BrutRequestDebuggingInfo—Chaîne facultative contenant les détails de la requête/réponse de niveau inférieur capturés (par ex. ligne de requête créée, en-têtes, nouvelles tentatives, calendrier) renseignés uniquement lorsque le débogage est activé ; Sinon, chaîne vide.