# 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="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2FOd2lmULy1GFVQ4yPs7wU%2Fprojekte-plus-symbol.png?alt=media&#x26;token=9941d613-faf3-446a-be0d-a46c684b4e2a" alt="" data-size="line"> Symbol.

<figure><img src="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2FDnbaVvSseDrJFzCw4ZCw%2Fconnector-json-01.png?alt=media&#x26;token=6614b3ed-8298-44df-a3e6-ebb20132c8c8" 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="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2FNwppchhBvadXCdVMGqh7%2Fconnector-json-02.png?alt=media&#x26;token=50535060-d9ea-4681-a378-999decd0ceab" 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="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2FinWuLfqbi9YfHLjB5o06%2Fconnector-json-03.png?alt=media&#x26;token=f0565259-da5d-4885-9d87-b7a066264984" 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="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2FWKUfquPsTaPGl86TkWw9%2Fconnector-json-workflow-generates-response.png?alt=media&#x26;token=99e6d95a-c3bf-432f-a494-c33579ada18c" alt="" width="563"><figcaption><p>Schalter "Workflow erzeugt Response"</p></figcaption></figure>

Mit dem Schalter <img src="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2Fgl4eSgGKKly1pFeUq0xs%2Fswitch.png?alt=media&#x26;token=31656e4f-6d4f-407e-8f17-b1f3a5fb136d" 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="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2Fgl4eSgGKKly1pFeUq0xs%2Fswitch.png?alt=media&#x26;token=31656e4f-6d4f-407e-8f17-b1f3a5fb136d" 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](https://help.aiaibot.com/robot/plugins/rest-apis-und-json/json-abfragen) 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="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2F7wOVCw5njcXxFuueyr7w%2Fconnector-sub-workflow-03.png?alt=media&#x26;token=54040504-3122-4e7e-9c5e-fcfcbdfa9fbb" alt="" data-size="line"> Symbol klicken.

<figure><img src="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2FnyNQPQCVsybRRRbjafXw%2Fconnector-json-04.png?alt=media&#x26;token=33452769-c1f4-4707-84f4-49870d87ba93" 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*.