activities
latest
false
Important :
Veuillez noter que ce contenu a été localisé en partie à l’aide de la traduction automatique. La localisation du contenu nouvellement publié peut prendre 1 à 2 semaines avant d’être disponible.
UiPath logo, featuring letters U and I in white

Activités de développeur

Dernière mise à jour 23 oct. 2025

Demande HTTP (HTTP Request)

UiPath.Web.Activities.Http.NetHttpClient

Important: This activity is available in WebAPI package versions starting with 2.0.0-preview and 2.3.0 GA. For the legacy experience, use the previous HTTP Request (legacy) activity included in WebAPI versions earlier than 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ètresAjoutez à votre demande des détails spécifiques au serveur sous forme de paires clé-valeur. Par exemple, query: "laptop", sortBy: "price".
En-têtesAjoutez 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")
      }#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")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")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

cURL Import and design time testing

This section helps you configure the activity via the cURL code snippets, and perform design time testing of the request.

  • cURL Command Text—Multiline design-time text field where a full cURL command can be pasted. Supports both `cm and bash styles.
  • cURL import button—Action button that immediately triggers parsing/import of the current cURL Command Text into the activity (method, URL, headers, body, auth, files).
  • Test request button—Action button that executes the configured request at design time. While running, it toggles to Cancel. On completion or cancellation it reverts to Test and updates Report field with formatted response or error.
  • Report—Multiline text area used to display the outcome of the last cURL import or design-time test execution (success summary, mapping details, warnings, or errors).

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.
  • Negotiated authentication—Use the HTTP Negotiate scheme for the runtime to select Kerberos or NTLM (and optionally Digest) based on server challenges. When Authentication is set to Negotiated authentication and Use operating system credentials = True, the current OS user context is used (Windows logon token; on Linux/macOS an existing Kerberos ticket, e.g. from kinit). Set Use operating system credentials = False to enable the Custom credentials field; supply a NetworkCredential (domain / username / password or secure password).

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.

Response options

This section helps you customize how the response will be returned by the server.

  • Always save tesponse as file—Force writing the response body to disk even when an attachment filename is not inferred.
  • Enable debugging info—Enable extended debug capture (raw request/response metadata, headers snapshot, timing, retry details) and output to the response object or during design time testing.
  • Output file name—Override the server-provided filename (e.g. from Content-Disposition).
  • Output file target folder—Control destination folder for the saved response files.
  • If the file already exists—Define collision strategy when a file with the resolved name already exists in the target folder. Options:
    • Auto rename—Append incremental suffix (_1, _2, …) to produce a unique filename.
    • Replace—Overwrite existing file.
    • Stop and discard—
    • Abort the save operation (and workflow if the exception is not handled) leaving existing file 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.
  • RawRequestDebuggingInfo—Optional string containing captured low-level request/response details (e.g. constructed request line, headers, retries, timing) populated only when debugging is enabled; empty string otherwise.
  • Description
  • Compatibilité du projet
  • Windows, configuration multiplate-forme

Cette page vous a-t-elle été utile ?

Obtenez l'aide dont vous avez besoin
Formation RPA - Cours d'automatisation
Forum de la communauté UiPath
Uipath Logo
Confiance et sécurité
© 2005-2025 UiPath Tous droits réservés.