> 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/connectoren/passiv/json.md).

# JSON

Mit dem JSON-Connector können Sie Daten im JSON-Format an Robot senden und anschliessend in einem Workflow verarbeiten. Dabei sind Sie an kein bestimmtes Schema gebunden, jedes syntaktisch korrekte JSON wird akzeptiert.

## Erstellen eines JSON-Connectors

Um einen neuen JSON-Connector zu erstellen, wählen Sie den Menüpunkt *Connectoren* und klicken anschliessend auf das <img src="/files/32GhkrdYgbHLeEkg44Lg" alt="" data-size="line"> Symbol.

<figure><img src="/files/CZ5eyvQDL9gV6KBW2glK" alt="" width="221"><figcaption><p>Erstellen eines neuen Connectors</p></figcaption></figure>

Anschliessend geben Sie einen Namen ein, wählen die Option *JSON* aus und klicken auf *Weiter*.

<figure><img src="/files/3SyVs36KixmCRCduLwWA" alt="" width="455"><figcaption><p>Neuer JSON-Connector</p></figcaption></figure>

## URL

Die URL, an die Sie Daten im JSON-Format senden können, wird angezeigt, sobald Sie den Connector öffnen. Ist das Feld leer und keine URL sichtbar, bedeutet das, dass Ihrem Projekt noch kein API-Key zugewiesen wurde. In diesem Fall wenden Sie sich bitte an Ihren Ansprechpartner, um einen API-Key zu erhalten.

<figure><img src="/files/dwPnEyXvRM9V58vu914s" alt="" width="563"><figcaption><p>URL des JSON-Connectors</p></figcaption></figure>

Daten können nur über die POST-Methode gesendet werden.

## Workflow erzeugt Response

Wenn ein Request für einen JSON-Connector eingeht, wird normalerweise sofort eine leere Antwort an den Sender geschickt. Es ist jedoch auch möglich, mit der Antwort zu warten, bis der Workflow abgeschlossen ist.

<figure><img src="/files/wMEdRCmuKW9kC73vwBLF" alt="" width="563"><figcaption><p>Schalter "Workflow erzeugt Response"</p></figcaption></figure>

Mit dem Schalter <img src="/files/BpEa4V86NFQFdQut15oJ" alt="" data-size="line"> *Workflow erzeugt Response* wird gewartet, bis der Workflow abgeschlossen ist, bevor die Antwort gesendet wird. Die Event-Variable `responseBody` wird dann als Antwort an den Sender zurückgeschickt. Diese Variable wird automatisch erstellt, wenn der Schalter aktiviert ist.

{% hint style="warning" %}
Stellen Sie sicher, dass das Timeout des Senders länger ist als die Verarbeitungsdauer des Workflows.
{% endhint %}

## Response Status-Code

Die Anfrage wird mit dem HTTP-Status-Code `200 OK` beantwortet, wenn der Schalter <img src="/files/BpEa4V86NFQFdQut15oJ" alt="" data-size="line">*Workflow erzeugt Response* aktiv ist. Bei inaktivem Schalter wird der HTTP-Status-Code `202 Accepted` zurückgeschickt.

Erhalten Sie einen anderen Status-Code, wurden Ihre Daten nicht akzeptiert und auch kein Workflow ausgelöst.

## Variablen

Um die Verarbeitung von JSON-Daten im Workflow zu erleichtern, können Sie bestimmte Daten mit einem JSON-Path-Ausdruck auslesen und in Variablen speichern. Diese Variablen stehen dann als Event-Variablen im Workflow zur Verfügung. Alternativ können Sie auch das Plugin [JSON abfragen](/robot/plugins/rest-apis-und-json/json-abfragen.md) im Workflow verwenden.

So erstellen Sie eine neue Variable:

1. Klicken Sie auf *Eine neue Variable hinzufügen*.
2. Geben Sie einen Namen für die Variable, den JSON-Path und den gewünschten Datentyp ein.
3. Bestätigen Sie Ihre Eingaben, indem Sie auf das <img src="/files/4QM4ndqmkcD1v7n1qlGK" alt="" data-size="line"> Symbol klicken.

<figure><img src="/files/pF8Hx86L8Tsez07lU062" alt="" width="557"><figcaption><p>Neue Variable für einen JSON-Connector</p></figcaption></figure>

{% hint style="info" %}
Wird der JSON-Pfad nicht gefunden, steht die Variable ohne initialen Wert im Workflow zur Verfügung.
{% endhint %}

Zum Abschluss bestätigen Sie die komplette Konfiguration mit einem Klick auf *Speichern*.