# Endpunkte

Eine API besteht zumeist aus mehreren Endpunkten. Die Endpunkte haben meist unterschiedliche Aufgaben wie das Lesen, Schreiben, Aktualisieren oder Löschen von Resourcen.

Um einen neuen Endpunkt zu erstellen, klicken Sie 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 am Ender der Liste.

Um einen Endpunkt zu bearbeiten, klicken Sie in der Liste darauf.

<figure><img src="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2F17zc0RBntMLF0binIccQ%2Fapi-endpoints-02.png?alt=media&#x26;token=c30be182-c937-459a-aca2-a62711eef090" alt="" width="563"><figcaption></figcaption></figure>

## Konfiguration

<figure><img src="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2FYGR6Fv91lEci5eDhXdlF%2Fapi-endpoints-01.png?alt=media&#x26;token=e2996569-b614-48a3-9904-29c55803f9df" alt="" width="563"><figcaption></figcaption></figure>

Jeder Endpunkt benötigt einen eindeutigen *Namen*, um ihn später in Workflows einfacher zu identifizieren. Für die *Request-Methode* stehen die Werte *`GET`*, *`POST`*, *`PUT`*, *`PATCH`* und *`DELETE`* zur Verfügung.

Der *Pfad* gibt an, wohin der Request am Server gesendet werden soll. Die vollständige URL des Endpunkts setzt sich aus dem Host der API-Spezifikation und dem hier angegebenen Pfad zusammen.

Mit dem Button *Testen* können Sie den Endpunkt aufrufen und überprüfen, ob er wie gewünscht funktioniert.

Spezielle Request-Header für diesen Endpunkt können ebenfalls hier definiert werden. Wenn Header auf Endpunkt- und API-Ebene den gleichen Namen haben, überschreiben die Endpunkt-Header die globalen API-Header.

Im mehrzeiligen Eingabefeld *Inhalt* kann der Request-Body definiert werden. Die Seite [JSON als Request-Body](https://help.aiaibot.com/robot/api-spezifikationen/json-als-request-body) beschreibt, wie JSON und Platzhalter zusammen mit Variablen verwendet werden können.

## Protokoll

Der Reiter *Protokoll* zeigt Ihnen wie oft dieser Endpunkt verwendet wurde. Neben dem Datum und der Ausführungszeit wird auch der Response-Code des Aufrufs angezeigt. Beim Klick auf einen Eintrag dieser Liste, werden Details angezeigt.

<figure><img src="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2FZWbNQxHeCJZ3B16ux9HF%2Fapi-endpoints-protocol-01.png?alt=media&#x26;token=e174921c-c710-473b-9379-e470e562ead2" alt="" width="563"><figcaption></figcaption></figure>

Im oberen Bereich des Protokolls sehen Sie das Ausführungsdatum und die Dauer des Aufrufs. Links ermöglichen den direkten Sprung zum Workflow-Protokoll, in dem dieser Aufruf stattgefunden hat. Die Navigation zum vorherigen bzw. nächsten Protokoll ist ebenfalls möglich.

Zusätzlich werden die Request-Methode, der Response-Code und die URL des Endpunkts angezeigt.

<figure><img src="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2FJiEYjvgz2ST3sOoc2ME6%2Fapi-endpoints-protocol-02.png?alt=media&#x26;token=f78e0bd9-dc0e-4bc1-a3b6-9ddc159a595d" alt=""><figcaption></figcaption></figure>

Der untere Bereich zeigt Request- und Response-Body sowie die dazugehörigen Header. Der Body kann entweder formatiert oder in seiner Originalform angezeigt werden, also genau so, wie er an den Server gesendet oder vom Server empfangen wurde.

<figure><img src="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2FFfu9nvUp122PrGoX2xNb%2Fapi-endpoints-protocol-03.png?alt=media&#x26;token=647617f9-ef78-404f-8213-f8cd547bf756" alt="" width="563"><figcaption></figcaption></figure>

Beim Klick auf *Header* werden Request- und Responser-Header angezeigt.

<figure><img src="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2FelbK1f7biWPduEDCeCuh%2Fapi-endpoints-protocol-04.png?alt=media&#x26;token=d9f050b6-ba07-45c5-a17f-0ba090ce6c92" alt="" width="563"><figcaption></figcaption></figure>

## Verwendung

Der letzte Reiter *Verwendung* zeigt Ihnen, in welchen Workflows dieser Endpunkt in Verwendung ist.

<figure><img src="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2F9ut44O1IPFOv8TuxmxJU%2Fapi-endpoints-usage-01.png?alt=media&#x26;token=79c6f740-6a82-448d-a4df-e71ca4ce8c1f" alt="" width="563"><figcaption></figcaption></figure>