Action - HTTP Request

Die Action HTTP Request sendet eine HTTP Anfrage an einen Server.

Hinweis: Diese Action ist für technische Requests (REST und ähnliche) gedacht und um die Antwort mit einem Script weiter zu verarbeiten. Um einen normalen Download durchzuführen, ist die Action Download URL zu bevorzugen.
Die Action beendet sich mit einem Statuscode -1 für generelle Fehler. Wenn die Verbindung zum Server nicht aufgebaut werden kann (Netzwerk nicht verfügbar, IP kann nicht aufgelöst werden), beendet sich die Action mit einem Fehler. Verwende eine Exception-Verbindung um solche Fehler abzufangen.

 

Beispiele:
  • Download einer Webseite eine Wetterdienstes und Analyse auf das Stichwort Regen
  • Preis eines Produktes bei einem Online Shop REST Service abfragen
Einstellungen
URL
Die URL die aufgerufen werden soll. Variablen werden unterstützt.
Beispiel:
  • http://example.com/weather.html?ts={triggertime,dateformat,yyyyMMdd} wird zu http://example.com/weather.html?ts=20110213
Zertifikate prüfen (https)
Ob Zertifikate geprüft werden sollen oder nicht. Das kann nützlich sein, um Fehler bei selbst-signierten Zertifikaten zu ignorieren.
Authentifizierung
Ob Benutzername und Passwort mittels Basic Authentication an den Server übergeben werden soll.
Benutzername
Der Benutzername. Variablen werden unterstützt.
Passwort
Das Passwort. Variablen werden unterstützt.
Client Zertifikat
Ob ein Client Zertifikat verwendet werden soll.
Client Zertifikat Pfad
Pfad zu einer PKCS#12 Datei. Variablen werden unterstützt.
Client Zertifikat Passwort
Das Passwort um auf das Client Zertifikat zuzugreifen. Variablen werden unterstützt.
Netzwerktyp
Ob das aktuelle Standardnetzwerkinterface, WiFi oder Mobilfunk für den Request verwendet werden soll.
Request Methode
Die HTTP Request Methode die verwendet werden soll. Nicht alle Methoden werden von allen Geräten unterstützt.
Content Typ
Der Content Type der bei der Anfrage im Header Content-Type gesendet werden soll. Variablen werden unterstützt.
Formular Feldliste
Komma separierte Liste mit Keys und zugehörigen Werten die als application/x-www-form-urlencoded an den Server übermittelt wird. Die Werte werden automatisch URL codiert. Variablen werden unterstützt.

Beispiel: Firstname=Hugo,Lastname=Habicht
Daten
Die zu übermittelnden Textdaten. Variablen werden unterstützt.
Form Feldname
De Name des Formular-Feldes für die hochzuladende Datei. Variablen werden unterstützt.
Datei zum hochladen
Die hochzuladende Datei. Der Dateiname im Request wird automatisch aus dem Dateinamen der lokalen Datei abgeleitet. Variablen werden unterstützt.
Timeout
Das zu verwendende Timeout
Eigene HTTP Headers
Ein Text mit den benutzerdefinierten Headern. Variablen werden unterstützt.

Jede Zeile sollte mit dem Namen des Header, einem Doppelpunkt und dem Wert des Headers gebildet werden.

Beispiele:
  • User-Agent: mein eigener user agent
  • SOAPAction: "test"
Daten
Die Daten die dem Server übergeben werden sollen als Text. Variablen werden unterstützt.
Speichere Antwort in einer Variable oder Datei
Ob die Antwort in einer Variable oder einer Datei gespeichert werden soll.
Variable
Der Name der Variablen um die Antwort zu speichern. Die Antwort wird in einen String konvertiert. Variablen werden unterstützt.

Warnung: Antworten grösser 1MB werden nicht unterstützt.
Encoding
Das Encoding, das verwendet werden soll, um die Antwort des Servers einzulesen. Leer lassen, um das von der Server Antwort angegebene Encoding zu verwenden.
Datei
Die Datei um das Resultat zu speichern. Variablen werden unterstützt.
Eine Variable ist ein Platzhalter für einen Wert und kann in vielen Actions und Conditions verwendet werden, um einen Text dynamisch zu definieren.
Siehe Action Script für eine Beschreibung.

Gelieferte Variablen
Name gemäss Definition des Feldes Variable
die Antwort als String
status_code
der numerische HTTP Statuscode, -1 bei einem allgemeinen Fehler
error_message
Fehlermeldung wenn der Request fehlschlägt und der status_code auf -1 gesetzt ist
header_*
Alle Werte der HTTP-Antwort-Header. Die Variablennamen werden durch das Prefix header_ und dem Namen des Headers gebildet, indem Bindestrich durch Underscore ersetzt wird und alle Zeichen klein geschrieben werden.
Beispiele:
  • Header Accept wird in Variable header_accept gespeichert
  • Header Accept-Encoding wird in Variable header_accept_encoding gespeichert
Werte von Headern, welche mehrfach in der Response gesendet werden, werden als Liste zur Verfügung gestellt.
Header welche keinen gültigen Variablennamen bilden, werden ignoriert.