# API-Endpunkt aufrufen

Mit dem Plugin <img src="/files/AEE7xtdEXwlhPEUFmjB5" alt="" data-size="line"> *API-Endpunkt aufrufen* können Sie einen zuvor [spezifizieren Endpunkt](/robot/api-spezifikationen.md) aufrufen.

## Eingabeparameter

<figure><img src="/files/98Np4rUgH39iBexyynCV" alt="" width="294"><figcaption></figcaption></figure>

### Parameter "API"

Mit diesem Auswahlfeld wählen Sie ein API aus, die sie zuvor im Menüpunkt [API](/robot/api-spezifikationen.md) festgelegt haben. Nachdem Sie eine Auswahl getroffen haben, wird der nächste Parameter *Endpoint* mit Auswahlmöglichkeiten befüllt.

### Parameter "Endpoint"

Diese Auswahlbox enthält die definierten Endpunkte der zuvor ausgewählten API.

### Parameter "Endpoint-Variablen"

In APIs und Endpunkten können [Platzhalter](/robot/api-spezifikationen/platzhalter.md) definiert werden, die während der Ausführung des Workflows durch die Werte von Variablen ersetzt werden. Für jeden definierten Platzhalter wird ein Auswahlfeld angezeigt. Wählen Sie eine Variable aus, die den Platzhalter ersetzen soll.

### 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.

{% hint style="info" %}
Dieser Parameter hat keinen Einfluss auf Response-Codes 4xx oder 5xx, welche für diese Plugin keinen Fehlerfall darstellen.
{% endhint %}

## Ausgabeparameter

<figure><img src="/files/FhsBd19Aj54meoz0Zi6X" alt="" width="290"><figcaption></figcaption></figure>

### Parameter "Response-Code"

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

### Parameter "Response-Header"

Alle Response-Header können in einer Variable vom Typ `text` gespeichert werden. Ein Header wird im Format `headerName: headerWert` abgespeichert. Sollten mehrere Header in der Response enthalten sein, werden diese mit `\n` (Newline) separiert 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-Body"

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

## Herunterladen von Dateien

Das Plugin ist auch in der Lage, Dateien (zum Beispiel Bilder im PNG- oder JPEG-Format, Dokumente im PDF- oder DOCX-Format, etc.) herunterzuladen. Wählen sie dafür beim Parameter "Response-Body" eine Variable vom Type `file` aus.

Voraussetzung dafür ist, dass ein korrekter `Accept` Header beim Endpunkt gesetzt wurde. Details dazu finden sie auf [dieser Seite](#herunterladen-von-dateien).


---

# Agent Instructions: 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:

```
GET https://help.aiaibot.com/robot/plugins/rest-apis-und-json/api-endpunkt-aufrufen.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.