HTTP-Abfrage

Das HTTP-Abfrage-Kommando führt eine Anfrage über das HTTP-Protokoll durch. Dies ist eine vom Client zum Server gesendete Zeilenfolge.

Parameter:

  • URL: Pfad/URL der Abfrage, beginnend mit „http://“ oder "https://".
  • Methode: Eine der gültigen Abfragemethoden, Default ist GET, eine andere häufig verwendete Methode für Uploads von Dateien ist POST.
  • Benutzername: Benutzername, welcher für eine HTTP-Basic-Authentifizierung benötigt wird. Verwendet der Server keine Authentifizierung kann dieser Parameter weggelassen werden.
  • Passwort: Passwort, welches für eine HTTP-Authentifizierung benötigt wird.
  • Parameter an URL anhängen: Bei Ja (Default) werden die HTTP Parameter (siehe HTTP-Abfrage Parameter) an die URL als Query-Parameter angehängt. Ansonsten werden sie als x-www-form-url-encoded Datensatz einer POST oder PUT Anfrage übermittelt, bzw. wenn mehr Nutzdaten gesendet werden (Anhänge, Daten), als Mime-Multipart Teile.
  • Redirect autom. folgen: Ein Ja/Nein Feld (Default ist Ja). Bei Ja wird bei einem sogenannten http-Redirect automatisch die neue URL geladen. Das http Abfrage-Ergebnis spiegelt dann das Ergebnis wieder, als wenn die Umleitungs-URL direkt aufgerufen wurde. Bei Nein wird der Umleitungsaufforderung des Servers nicht Folge geleistet. Der http Status ist dann entsprechend z.B. 302 und im Antwort-Header „Location“ findet sich die Umleitungs-URL.
  • Daten: Bei POST oder PUT Anfragen können als „Nutzlast“ Daten übermittelt werden, eine Möglichkeit ist es, Daten hier mitzugeben. Diese werden dann entweder als Body gesendet, oder falls schon Daten im Body sind (Anhänge oder Parameter) als zusätzlicher Anhang.
  • Zielvariable Status: Hier kann eine variable angegeben werden, in der der http Status (Numerisch) der Abfrage gespeichert wird. Stati zwischen 200 und 299 gelten üblicherweise als OK.
  • Zielvariable Inhalt: Werden von der Abfrage Daten gesendet, kann hier eine Variable angegeben werden, in der diese gespeichert werden.
  • Zieldatei: Angabe eines Dateipfades, in der die HTTP-Antwort geschrieben werden soll. Es kann eine beliebige Datei angegeben werden. Vorsicht: Ist die Datei schon vorhanden, wird diese überschrieben.
  • Timeout Aufbau (s): Ein Timeout in Sekunden, nach dem der Versuch eines Verbindungsaufbau beendet werden soll. Ab Version 2.2.1 wird als Standard 2 Minuten angenommen.
  • Timeout Übertragung (s): Ein Timout in Sekunden, falls der Server nicht auf gesendete Daten reagiert, wird die Verbindung abgebrochen. Ab Version 2.2.1 wird als Standard 5 Minuten angenommen.
  • Keystore für mTLS: Pfad zu einer Keystore-Datei (p12), welche ein Client-Zertifikat für eine mTLS Authentifizierung beinhaltet
  • Keystore-Passwort: Passwort für einen evtl. angegebenen Keystore-Pfad