# API-Endpunkt aufrufen

Mit dem Plugin <img src="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2FsOI3dnjxTSXpBUhPLGwm%2Fplugin-call-api-01.png?alt=media&#x26;token=b6b487ca-d0ca-4120-ad75-d8b971c85d44" alt="" data-size="line"> *API-Endpunkt aufrufen* können Sie einen zuvor [spezifizieren Endpunkt](https://help.aiaibot.com/robot/api-spezifikationen) aufrufen.

## Eingabeparameter

<figure><img src="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2FjW9AsKKER6gibdmI74yH%2Fplugin-call-api-02.png?alt=media&#x26;token=65822c08-a9ac-4963-9bac-997168fef922" alt="" width="294"><figcaption></figcaption></figure>

### Parameter "API"

Mit diesem Auswahlfeld wählen Sie ein API aus, die sie zuvor im Menüpunkt [API](https://help.aiaibot.com/robot/api-spezifikationen) 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](https://help.aiaibot.com/robot/api-spezifikationen/platzhalter) 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="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2FrStOMtXvAYjBJtB3B51H%2Fplugin-call-api-03.png?alt=media&#x26;token=37626c41-a06d-4420-8a2a-942d081ac72f" 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](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-Body"

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