HTTP-Anfrage (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.

Beschreibung

Verwenden Sie die Aktivität HTTP Request in der Vorschau von WebAPI 2.0.0, um das Stellen von Anfragen an Webserver oder APIs zu automatisieren und zu vereinfachen. Mit der Aktivität HTTP Request können Sie:

• Senden und empfangen Sie Daten sicher zwischen Systemen.
• Laden Sie Dateien und Daten mithilfe von Formularen hoch.
• Behandeln Sie Fehler ordnungsgemäß, indem Sie Anforderungen wiederholen, wenn etwas schief läuft.
• Stellen Sie eine sichere Verbindung mit SSL her, um Daten zu schützen.
• Verwalten Sie Cookies und Proxys automatisch, um Sitzungs- und Netzwerkbeschränkungen zu verarbeiten.

Projektkompatibilität

Windows | Plattformübergreifend

Windows, plattformübergreifende Konfiguration

Texteigenschaften der Aktivität
Anforderungsmethode *	Wählen Sie aus, wie Ihre HTTP-Anforderung mit dem Server interagieren soll: GET– Ruft Daten ab, ohne sie zu ändern. POST– Sendet Daten an den Server, normalerweise um eine Ressource zu erstellen oder zu aktualisieren. PUT– Aktualisiert eine vorhandene Ressource. DELETE– Entfernt eine angegebene Ressource vom Server. HEAD– Ähnlich wie GET, ruft aber nur Header ohne den Textinhalt ab. OPTIONS– Gibt Informationen zu den auf dem Server verfügbaren Kommunikationsoptionen an. PATCH– Aktualisiert teilweise eine vorhandene Ressource. TRACE– Wird zu Diagnosezwecken verwendet und sendet die empfangene Anforderung an den Client zurück.
Anforderungs-URL *	Geben Sie die Webadresse des Servers an, an den Sie Ihre Anforderung senden möchten. Beispiel: https://store.example.com/search.
Parameter	Fügen Sie serverspezifische Details zu Ihrer Anforderung als Schlüssel-Wert-Paare hinzu. Beispiel: query: "laptop", sortBy: "price".
Header	Fügen Sie serverspezifische Anweisungen oder Authentifizierungsdetails als Schlüssel-Wert-Paare hinzu. Beispiel: Authorization: "Bearer <your_access_token>", Accept: "application/json".
Texttyp der Anforderung *	Wählen Sie den Inhaltstyp aus, den Sie an den Server senden möchten: Keine– Sendet keine Daten, normalerweise für Abrufmethoden. Text– Sendet Daten als Nur-Text, normalerweise für POST- und PUT-Methoden. Nach der Auswahl werden die folgenden Felder angezeigt: Textinhaltstyp– Wählen Sie das Format des Texts aus, den Sie in Ihrer HTTP-Anforderung senden möchten, damit der Server weiß, wie er zu interpretieren ist: text/Plain– Regulärer Nur-Text. text/html– HTML-formatierter Text. text/css– CSS-formatierter Text. text/csv– Strukturierte Daten, die als CSV formatiert sind. text/xml– XML-formatierter Text, der von Menschen gelesen werden kann. Anwendung/xml– XML-formatierter Text, der für die Verarbeitung von Anwendungen vorgesehen ist. application/json– JSON-formatierter Text. Text– Schreiben Sie den Text oder die Daten, die Sie in Ihrer Anforderung senden möchten. Textcodierung– Wählen Sie das Codierungsformat für die Textnutzlast aus, z. B. Unicode, ASCII oder ISO. Dadurch wird sichergestellt, dass der empfangende Server Ihre Textnutzlast genau liest. Formular URL codiert– Sendet Daten, die als einfache Schlüssel-Wert-Paare formatiert sind. Nach der Auswahl wird das folgende Feld angezeigt: URL-codierte Formulardaten– Geben Sie die Schlüssel-Wert-Paare an. Beispiel: searchQuery: "Smartphone", brand: "XYZ", inStock: "true". Mehrteilige Formulardaten– Sendet Dateien oder komplexe Daten. Verwenden Sie diese Option, wenn Sie verschiedene Datentypen in Ihrer Anforderung kombinieren müssen. Nach der Auswahl werden die folgenden Felder angezeigt: Ressourcendateien– Geben Sie den Namen der Dateien an, die in Ihrem Projekt als IResource-Objekte gespeichert sind. Lokale Dateien– Geben Sie den Pfad zu einer Datei auf Ihrem Gerät an. Beispiel: "C:/Images/product-photo.jpg". Formulardatenteile– Geben Sie eine Sammlung von FormDataPartan Objekte: TextFormDataPart – Für Zeichenfolgen-Nutzdaten, z. B. JSON oder Nur-Text. BinaryFormDataPart – Für unformatierte Byte-Arrays. FileFormDataPart –Für Dateistreams basierend auf einem bestimmten Pfad. Zum Beispiel eine FormDataPart -Auflistung mit dem Ausdrucks-Editor: #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") } Jeder FormDataPart -Typ verfügt über mehrere Konstruktoren, sodass Sie von häufig verwendeten Standardeinstellungen profitieren können. Die Aktivität weist automatisch den richtigen Content-Type- Header für jedes FileFormDataPart zu. Sie können diesen Header manuell überschreiben. Bei Dateilisten können Sie den automatisch zugewiesenen Header nicht überschreiben. Für Ressourcendateilisten verwendet die Aktivität den verfügbaren MIME-Typ. URL-codierte Formulardaten– Geben Sie einfache Schlüssel-Wert-Paare an. Binär– Sendet Rohdaten. Nach der Auswahl wird das folgende Feld angezeigt: Binäre Nutzlast– Geben Sie die Rohdatennutzlast an, z. B. Bilder, Videos, große Dateien oder Streaming-Daten. Zum Beispiel das Senden eines Bildes in binärer Form: File.ReadAllBytes("C:/Images/product-image.jpg") Stream– Sendet kontinuierliche Daten, z. B. das Hochladen einer großen Datei (Studio oder Video), wenn die Daten nicht vollständig auf einmal in den Speicher geladen werden können. Nach der Auswahl wird das folgende Feld angezeigt: Lokale Datei– Geben Sie den großen Dateipfad an, z. B.: File.OpenRead("C:/Videos/large-video.mp4") Die Aktivität weist automatisch den richtigen Inhaltstyp- Header für die hochgeladene Datei zu. Sie können diesen Header manuell überschreiben.

Eigenschaften-Panel
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).
Clientoptionen Dieser Abschnitt hilft Ihnen, verbindungsbezogene Einstellungen zu definieren.	SSL-Überprüfung deaktivieren– Überspringt SSL-Sicherheitsüberprüfungen. Nützlich für Tests (True), nicht für die Produktion empfohlen (False, Standard). TLS-Protokoll– Wählt das TLS-Protokoll für sichere Verbindungen aus. Verfügbare Optionen sind Automatisch (Standard), TLS 1.2 und TLS 1.3. Cookies aktivieren– Aktiviert standardmäßig die automatische Cookie-Verarbeitung (True). Legen Sie False fest, um die automatische Cookie-Verarbeitung zu deaktivieren. Clientzertifikat– Gibt den Pfad zum Clientzertifikat für die Authentifizierung mit sicheren APIs an. Beispiel: "C:/certificates/client-cert.pfx". Sicheres Clientzertifikat-Kennwort– Speichert das sichere Kennwort für das bereitgestellte Clientzertifikat. Beispiel: "certPassword". Wechseln Sie zwischen einfachen und sicheren Kennwörtern, indem Sie das Plus-Symbol und die gewünschte Option auswählen: Nur Zeichenfolge verwenden und Sichere Zeichenfolge verwenden. Proxykonfiguration– Konfiguriert benutzerdefinierte Proxys, einschließlich Unterstützung für Authentifizierungs- und Umgehungslisten. Beispiel: "http://proxy.example.com:8080".
Authentication In diesem Abschnitt können Sie definieren, wie sich die Aktivität beim Server authentifiziert.	Authentifizierung– Wählen Sie die Authentifizierungsmethode aus. Verfügbare Optionen sind: Keine Authentifizierung– Der Server benötigt keine Benutzervalidierung, um Ihre Anforderung zu akzeptieren. Standardauthentifizierung– Bietet eine Benutzervalidierung für den empfangenden Server durch Benutzername und sicheres Kennwort. Wechseln Sie zwischen einfachen und sicheren Kennwörtern, indem Sie das Plus-Symbol und die gewünschte Option auswählen: Nur Zeichenfolge verwenden und Sichere Zeichenfolge verwenden. Bearer-Token– Bietet eine Benutzervalidierung für den empfangenden Server über ein eindeutiges Bearer-Token, das nach der Anmeldung generiert wird. 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).
Anforderungsoptionen Dieser Abschnitt hilft Ihnen, das Verhalten der Anforderung zu definieren.	Zusätzliche Cookies– Geben Sie zusätzliche Cookies manuell als Schlüssel-Wert-Paare an. Anforderungs-Timeout– Geben Sie die maximale Wartezeit in Millisekunden an, bevor die Anforderung abgebrochen wird. Der Standardwert ist 10.000 Millisekunden (10 Sekunden). Bei Fehler fortfahren– Legen Sie fest, ob die Automatisierung auch dann fortgesetzt werden soll, wenn die Aktivität einen Fehler ausgibt (True, Standardoption). Um die Automatisierung zu beenden, wenn ein Fehler auftritt, verwenden Sie False. Weiterleitungen folgen– Legen Sie fest, ob Ihre Anforderung automatisch den vom Server bereitgestellten URL-Umleitungen folgen soll (True, Standardoption). Um Weiterleitungen zu ignorieren und die ursprüngliche Antwort zu verwenden, verwenden Sie False. Maximale Umleitungen– Geben Sie an, wie vielen automatischen Umleitungen Sie folgen sollen, bevor sie angehalten werden. Der Standardwert ist 3.
Wiederholungsrichtlinie Dieser Abschnitt hilft Ihnen, den Wiederholungsmechanismus im Falle eines Anforderungsfehlers zu definieren.	Richtlinientyp für Wiederholungen– Geben Sie die Methode für die Wiederholung von Anforderungen an. Verfügbare Optionen sind: Keine Wiederholung– Ihre Anforderung ruft den Server nur einmal auf. Wenn sie fehlschlägt, gibt es keine weiteren Versuche. Grundlegende Wiederholung– Wiederholt die Anforderung nach Fehlern mit einer festen Verzögerung. Anzahl der Wiederholungen– Geben Sie an, wie oft wiederholt werden soll. Der Standardwert ist 3. Verzögerung– Geben Sie die feste Zeit zwischen den Wiederholungen in Millisekunden an. Der Standardwert ist 500 Millisekunden (0,5 Sekunden). Use Retry-After-Header– Entscheiden Sie, ob die Anforderung den vom Server empfohlenen Retry-After -Header verwenden soll (True, Standardoption). Um den Headerwert Retry-After zu ignorieren, verwenden Sie False. Verzögerungslimit– Geben Sie die maximal zulässige Verzögerung zwischen „Wiederholen“ und „Nach “ in Millisekunden an. Der Standardwert ist 30.000 Millisekunden (30 Sekunden). Statuscodes für Wiederholungen– Geben Sie die Statuscodes an, die Wiederholungen auslösen sollen. Exponentieller Backoff– Wiederholungsversuche mit steigenden Verzögerungen zwischen den einzelnen Versuchen. Anzahl der Wiederholungen– Geben Sie an, wie oft wiederholt werden soll. Der Standardwert ist 3. Anfängliche Verzögerung– Geben Sie die Verzögerungszeit vor der ersten Wiederholung in Millisekunden an. Der Standardwert ist 500 Millisekunden (0,5 Sekunden). Multiplikator– Geben Sie die Zahl an, die verwendet wird, um die Verzögerung nach jeder fehlgeschlagenen Anforderung zu erhöhen. Der Standardwert ist 2, wodurch die Verzögerung jedes Mal verdoppelt wird. Jeweilsbei Verzögerungen entscheiden Sie, ob Sie einen zufälligen Versatz zwischen 0 und 100 Millisekunden hinzufügen möchten, um synchronisierte Wiederholungen zu vermeiden (Standard:True). Use Retry-After-Header– Entscheiden Sie, ob die Anforderung den vom Server empfohlenen Retry-After -Header verwenden soll (True, Standardoption). Um den Headerwert Retry-After zu ignorieren, verwenden Sie False. Verzögerungslimit– Geben Sie die maximal zulässige Verzögerung zwischen „Wiederholen“ und „Nach “ in Millisekunden an. Der Standardwert ist 30.000 Millisekunden (30 Sekunden). Statuscodes für Wiederholungen– Geben Sie die Statuscodes an, die Wiederholungen auslösen sollen.
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.
Ausgabe Dieser Abschnitt hilft Ihnen, die vom Server zurückgegebene Antwort zu erfassen und zu speichern.	Antwortinhalt– Erfasst die Antwort vom Server und speichert sie für die zukünftige Verarbeitung in einer Variablen. Es beinhaltet: StatusCode– Statuscode der HTTP-Antwort. TextContent– Antwort als Nur-Text (falls verfügbar). BinaryContent– Rohe Antwortdaten für Nicht-Textinhalte. Datei– Antwort wird als Datei (ILocalResource) in Ihrem Download-Ordner gespeichert. Der Dateiname stammt aus Antwortheadern oder wird automatisch generiert, um Überschreiben von Dateien zu vermeiden. Header– Alle HTTP-Antwortheader. ContentHeaders– Header, die sich speziell auf den Antwortinhalt beziehen. Zum Beispiel Content-Type und 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.