# REST Web-Service aufrufen

Mit dem Plugin <img src="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2FNLujyMUKtBAKTWIsSlyP%2Fplugin-call-rest-web-service-01.png?alt=media&#x26;token=28a7218f-40ac-4bee-ab04-fbdfad11e4ae" alt="" data-size="line">*REST Web-Service aufrufen* können Sie Web-Requets absetzen.

## Eingabeparameter

<figure><img src="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2F51Xiyj0nf6kZvEQKow3o%2Fplugin-call-rest-web-service-02.png?alt=media&#x26;token=1b1a0c58-80fe-45b8-83f0-7f1fbd336906" alt="" width="293"><figcaption></figcaption></figure>

### Parameter "URL"

Hier definieren Sie die URL, an die der Request geschickt werden soll.

### Parameter "Methode"

In diesem Auswahlfeld wählen Sie die Method aus, wie der Request abgeschickt werden soll. Es stehen `GET`, `POST`, `PUT`, `DELETE` und `PATCH` zur Verfügung.

### Parameter "Header"

In diesem mehrzeiligen Eingabefeld spezifizieren Sie die Request-Header. Das Format, in dem ein Header eingegeben werden muss ist `headerName: headerWert`. Definieren Sie pro Zeile genau einen Header.

### Parameter "Content Type"

Mit dieser Auswahlbox können Sie den Content Type des Requests festlegen.

{% hint style="info" %}
Wenn Sie einen Request-Body definieren, müssen Sie den Content-Type auswählen.
{% endhint %}

### Parameter "Request-Body"

Hier legen Sie den Body des Requests fest. Damit der Request korrekt verarbeitet werden kann, müssen Sie einen Wert für den Parameter *Content Type* auswählen.

### Parameter "Verhalten im Fehlerfall"

Mit diesem Parameter steuern Sie, wie sich der Workflow im Fall eines Fehler verhalten soll. Zu Fehler zählen zum Beispiel ein ungültiger Hostname oder Netzwerkprobleme bei der Datenübertragung.

Im Gegensatz zum Plugin [API-Endpunkt aufrufen](https://help.aiaibot.com/robot/plugins/rest-apis-und-json/api-endpunkt-aufrufen), bricht dieses Plugin den Workflow ab, wenn ein 4xx oder 5xx Response Code vom Endpunkt zurückgeliefert wird.

## Ausgabeparameter

<figure><img src="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2Fg4CxmXB5WFVEFWlWIj8e%2Fplugin-call-rest-web-service-03.png?alt=media&#x26;token=636e80c6-60ef-4199-a8e6-7cf42e82d5dc" alt="" width="294"><figcaption></figcaption></figure>

### Parameter "Response-Body"

Der Body einer Response kann in einer Variable vom Typ `text` oder `json` gespeichert werden.

### Parameter "Response-Header"

Alle Response-Header können in einer Variable vom Typ `text` gespeichert werden. Jeder Header wird im Format `headerName: headerWert` abgelegt. Enthält die Response mehrere Header, werden diese durch `\n` (Zeilenumbruch) voneinander getrennt gespeichert.

Mit dem Plugin [Teilen eines Textes](https://help.aiaibot.com/robot/plugins/textverarbeitung/teilen-eines-textes) ist es möglich, die Header in einer Variable vom Typ `collection` umzuwandeln.

### Parameter "Response-Code"

Wählen Sie eine Variable vom Typ `integer` in dem der Response-Code gespeichert werden soll.