> For the complete documentation index, see [llms.txt](https://help.aiaibot.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.aiaibot.com/robot/plugins/rest-apis-und-json/rest-web-service-aufrufen.md).

# REST Web-Service aufrufen

Mit dem Plugin <img src="/files/gtJo0pTHTrO3wH4VUABf" alt="" data-size="line">*REST Web-Service aufrufen* können Sie Web-Requets absetzen.

## Eingabeparameter

<figure><img src="/files/iYbrRLnzgESiykW2yVbx" 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](/robot/plugins/rest-apis-und-json/api-endpunkt-aufrufen.md), bricht dieses Plugin den Workflow ab, wenn ein 4xx oder 5xx Response Code vom Endpunkt zurückgeliefert wird.

## Ausgabeparameter

<figure><img src="/files/yA1mGkl3bMK0mV8Sxacb" 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](/robot/plugins/textverarbeitung/teilen-eines-textes.md) 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.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.aiaibot.com/robot/plugins/rest-apis-und-json/rest-web-service-aufrufen.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.