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


---

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