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é Demande HTTP dans WebAPI 2.0.0-preview pour automatiser et simplifier l’envoi de requêtes aux serveurs Web ou aux API. L’activité Requête HTTP 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 | Multiplate-forme

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 : GET : 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 : similaire à 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. TRAçage : utilisé à des fins de diagnostic, répertoriant la requête reçue du 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 requête des informations spécifiques au serveur sous la 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 : envoie les données en texte brut, généralement pour les méthodes POST et PUT. Une fois sélectionnés, les champs suivants s'affichent : Type de contenu de 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/ Normal : texte brut régulier. text/html : texte au format HTML. texte/css : texte au format CSS. text/csv : Données structurées au format CSV. texte/xml : texte au format XML, destiné à être lu par des humains. application/xml : texte au format XML destiné au traitement des applications. application/json - Texte au format JSON. Texte : écrivez le texte ou les données réels que vous souhaitez envoyer dans votre demande. Encodage du texte : sélectionnez le format d’encodage pour la charge utile du texte. Cela garantit que le serveur de réception lit avec précision votre charge utile de texte. URL de formulaire encodé : envoie des données formatées sous forme de simples paires clé-valeur. Une fois sélectionné, le champ suivant s'affiche : Données de formulaire encodées en URL : 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 requête. Une fois sélectionnés, les champs suivants s'affichent : Fichiers de ressources : 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 : fournissez une collection d'objets FormDataPart : TextFormDataPart : pour les charges utiles de chaîne, telles que JSON ou le texte brut. BinaireFormDataPart : pour les tableaux d'octets bruts. FileFormDataPartage : pour les flux de fichiers 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 encodées en URL : fournissez des paires clé-valeur simples. Binaire : envoie des données brutes. Une fois sélectionné, le champ suivant s'affiche : Charge utile binaire : fournissez la charge utile des données brutes, telle que des images, des vidéos, des fichiers volumineux ou des données de diffusion. Par exemple : File.ReadAllBytes("C:/Images/product-image.jpg") Flux : envoie des données en continu, comme le téléchargement d’un fichier volumineux (audio ou vidéo), lorsque les données ne peuvent pas être entièrement chargées en mémoire en même temps. Une fois sélectionné, le champ suivant s'affiche : Fichier local : indiquez le chemin d’accès au fichier volumineux. L'activité attribue automatiquement l'en-tête Content-Type correct pour le fichier téléchargé. Vous pouvez remplacer cet en-tête manuellement. Par exemple : File.OpenRead("C:/Videos/large-video.mp4")

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.
Options du client Cette section vous aide à définir les paramètres liés à la connexion.	Désactiver la vérification SSL : ignore les vérifications de sécurité SSL. Utile pour les tests ( Vrai ), non recommandé pour la production ( Faux, par défaut). Protocole TLS : sélectionne le protocole TLS pour des connexions sécurisées. Les options disponibles sont Automatique (par défaut), TLS 1.2 et TLS 1.3 . Activer les cookies - Par défaut, active la gestion automatique des cookies ( True ). Définissez sur False pour désactiver la gestion automatique des cookies. Certificat client : 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 : stocke le mot de passe sécurisé du 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 une chaîne simple et Utiliser une chaîne sécurisée . Configuration proxy : configure des proxys personnalisés, y compris la prise en charge de l'authentification et des listes 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 : le serveur n'exige pas la validation de l'utilisateur pour accepter votre demande. Authentification de base : fournit une validation de l'utilisateur au serveur de réception via un nom d'utilisateur et un 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 une chaîne simple et Utiliser une chaîne sécurisée . Jeton du porteur : fournit la validation de l'utilisateur au serveur reçu via un jeton du porteur unique généré après la connexion. Authentification négociée : utilisez le schéma HTTP Negotiate pour le runtime afin de 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 des cookies supplémentaires sous la forme de paires clé-valeur. Délai d’attente de la requête : spécifiez le temps d’attente maximal, en millisecondes, avant l’abandon de la requête. La valeur par défaut est de 10 000 millisecondes (10 secondes). Continuer en cas d'erreur : déterminez si l'automatisation doit se poursuivre même lorsque l'activité génère une erreur ( Vrai , option par défaut). Pour arrêter l’automatisation lorsqu’une erreur se produit, utilisez Faux . Suivre les redirections : Déterminez si votre demande doit automatiquement suivre les redirections d'URL fournies par le serveur ( Vrai , option par défaut). Pour ignorer les redirections et utiliser la réponse initiale, utilisez Faux . Nombre maximum de redirections : spécifiez le nombre de redirections automatiques que vous demandez 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.	Type de stratégie de nouvelle tentative : spécifiez la méthode de nouvelle tentative des requêtes. Les options disponibles sont les suivantes : Aucune nouvelle tentative : votre demande appelle le serveur une seule fois. En cas d'échec, aucune autre tentative ne sera effectuée. Nouvelle tentative de base : réessaye la requête après des échecs en utilisant un délai fixe. Nombre de nouvelles tentatives : 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 définie sur 500 millisecondes (0,5 seconde). Utiliser l'en-tête Réessayer-Après : déterminez 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 , utilisez Faux . Limite de délai : spécifiez le délai maximal autorisé entre les nouvelles tentatives , en millisecondes. La valeur par défaut est de 30 000 millisecondes (30 secondes). Codes de nouvelle tentative de statut : spécifiez les codes de statut qui doivent déclencher de nouvelles tentatives. Interruption exponentielle : effectue une nouvelle tentative avec des délais croissants entre chaque tentative. Nombre de nouvelles tentatives : spécifiez le nombre de nouvelles tentatives. La valeur par défaut est 3. Délai initial : spécifiez le délai avant la première nouvelle tentative, en millisecondes. La valeur par défaut est définie sur 500 millisecondes (0,5 seconde). Multiplicateur : spécifiez le nombre utilisé pour augmenter le délai après chaque échec de requête. La valeur par défaut est 2, ce qui double le délai à chaque fois. Utiliser la bascule : pour les retards, décidez si vous souhaitez ajouter un décalage aléatoire entre 0 et 100 millisecondes pour éviter les nouvelles tentatives synchronisées ( True , par défaut). Utiliser l'en-tête Réessayer-Après : déterminez 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 , utilisez Faux . Limite de délai : spécifiez le délai maximal autorisé entre les nouvelles tentatives , en millisecondes. La valeur par défaut est de 30 000 millisecondes (30 secondes). Codes de nouvelle tentative de statut : 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.	Toujours enregistrer la réponse en tant que fichier : force à écrire le 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 : activez la capture de débogage étendue et la 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 de Content-Disposition). Dossier cible du fichier de sortie : 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, etc. pour produire un nom de fichier unique. Remplacer : é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. Remarque : L’activité ne prend en charge qu’un seul mode de sortie à la fois: soit enregistrer la réponse sous forme de fichier, soit renvoyer les données de la réponse sous forme de texte. La configuration simultanée des deux sorties n’est pas prise en charge.
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 : le code de statut de la réponse HTTP. ContenuTexte : la réponse en texte brut (si disponible). Contenu Binaire : 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 les fichiers. En-têtes : Tous les en-têtes de réponse HTTP. En-têtes de contenu : En-têtes spécifiquement liés au contenu de la réponse. Par exemple, Content-Type et Content-Length . InfosDébogageBrute - 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.