> For the complete documentation index, see [llms.txt](https://docs.buildings.ability.abb/collection/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.buildings.ability.abb/collection/german/pflichtbasis/platform-core/connect-hub/connectivity-as-a-service/connect-devices-via-restful.md).

# Geräte über RESTful verbinden

## Über RESTful

Mit RESTful können Sie HTTP-Anfragen (GET, POST, PUT, DELETE) senden, um *Ressourcen*. Eine *Ressource* kann alles sein, was Informationen enthält, z. B. Dokumente, Bilder oder Dienste.

Jede Ressource hat ihre eigene URL. Clients (z. B. BuildingPro Suites) senden HTTP-Anfragen an diese URL. Als Antwort erhalten Clients Statuscodes und Repräsentationen der angeforderten Daten vom Server, normalerweise als .json oder .xml.

In den meisten Fällen wird RESTful verwendet, um externe Geräte oder Dienste über ihre API per GET-Anfrage in BuildingPro Suites zu integrieren.

## Was ist der Unterschied zwischen RESTful und Webhook?

Der wesentlichste Unterschied ist die Richtung der Kommunikation.

* Bei RESTful sendet ein Client Anfragen an einen Server. Der Server antwortet mit einem Statuscode und (wenn möglich) den angeforderten Daten. Für die Kommunikation über RESTful müssen die genaue Adresse des Servers sowie die einzelnen Endpunkte bekannt sein.
* Bei Webhook geht die Kommunikation vom Server aus. Der Server sendet aktiv in Echtzeit Daten an den Client. Der Client muss keine Anfragen senden. Für die Kommunikation über Webhooks muss der Server die Adresse des Clients kennen.

## Vorgehen

Das Verfahren zur Integration von Geräten über RESTful kann in die folgenden Schritte unterteilt werden:

1. Zuerst wird eine *Verbindung* erstellt und konfiguriert. Diese Verbindung enthält die Basis-URL zu einer API.
2. In dieser Verbindung werden einzelne *Anfragen* erstellt. In diese Anfragen werden die einzelnen Parameter eingetragen, die abgefragt werden sollen.

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FERsOA5LMqF3orziqLlXf%2FDocs_Verbindungen%20-%20Verbindungen%20RESTful%20BaseURL.png?alt=media&#x26;token=83d24c66-cac3-40de-9434-27806c273170" alt=""><figcaption></figcaption></figure>

## Übersicht

<figure><img src="/files/2f7c9539b5cd26d9c2771c24bdad9a13b8b0ad22" alt=""><figcaption><p>Abb. 1 – RESTful-Verbindungen</p></figcaption></figure>

<figure><img src="/files/a278beed891dc094204261e7c57a98c3a233caaf" alt=""><figcaption><p>Abb. 2 – RESTful-Verbindungen (Details)</p></figcaption></figure>

<table data-full-width="true"><thead><tr><th width="69.53334554036456">Symbol</th><th width="205.20001220703125">Beschreibung</th><th>Details</th></tr></thead><tbody><tr><td><strong>[A]</strong></td><td>Menü „Verbindungen“</td><td>Klicken Sie, um das Menü „Verbindungen“ zu öffnen</td></tr><tr><td><strong>[B]</strong></td><td>Registerkarte</td><td>Zugriff auf die jeweiligen Schnittstellen</td></tr><tr><td><strong>[C]</strong></td><td>Arbeitsbereich</td><td>Zeigt eine Liste der vorhandenen Verbindungen an (falls vorhanden)</td></tr><tr><td><strong>[D]</strong></td><td>Verbindung</td><td>Eine vorhandene Verbindung</td></tr><tr><td><strong>[E]</strong></td><td>Anfragen ein-/ausblenden</td><td>Klicken Sie, um die dieser Verbindung zugewiesenen Anfragen ein- oder auszublenden</td></tr><tr><td><strong>[F]</strong></td><td>Anfragen</td><td>Einzelne Anfragen</td></tr><tr><td><strong>[G]</strong></td><td>Verbindung pausieren/fortsetzen</td><td>Klicken Sie, um eine Verbindung zu pausieren oder fortzusetzen</td></tr><tr><td><strong>[H]</strong></td><td>Verbindungsstatus</td><td>Zeigt den aktuellen Status der Verbindung an</td></tr><tr><td><strong>[I]</strong></td><td>Name</td><td>Name der Verbindung</td></tr><tr><td><strong>[J]</strong></td><td>URL</td><td>Die Basis-URL der jeweiligen Verbindung</td></tr><tr><td><strong>[K]</strong></td><td>Anfragen</td><td>Zeigt an, wie viele Anfragen dieser Verbindung zugeordnet sind</td></tr><tr><td><strong>[L]</strong></td><td>Anfrage hinzufügen</td><td>Klicken Sie, um der jeweiligen Verbindung eine Anfrage hinzuzufügen</td></tr><tr><td><strong>[M]</strong></td><td>Neue Verbindung</td><td>Klicken Sie, um eine neue Verbindung zu erstellen</td></tr><tr><td><strong>[N]</strong></td><td>Verbindungsdetails</td><td>Klicken Sie, um die Details der jeweiligen Verbindung zu öffnen. Öffnet die ↗Verbindungsdetails</td></tr><tr><td><strong>[O]</strong></td><td>Verbindung löschen</td><td>Löscht die jeweilige Verbindung. ⚠ Vorsicht: Wenn die Verbindung auch in anderen Mandanten verwendet wird, wird sie dort ebenfalls gelöscht.</td></tr><tr><td><strong>[P]</strong></td><td>Anfragedetails</td><td>Klicken Sie, um die Details der jeweiligen Anfrage zu bearbeiten.</td></tr></tbody></table>

## Neue Verbindung erstellen

1. Klicken Sie in der Seitenleiste auf **Verbindung \[A]**

   ▷ Das Fenster "Verbindungen" öffnet sich
2. Wählen Sie den **RESTful \[B]** Tab
3. Im Arbeitsbereich **\[C]**, eine Liste der bereits vorhandenen Verbindungen **\[D]** angezeigt

   ◈ Wenn Sie keine Einträge sehen, sind noch keine Verbindungen vorhanden

   ◈ Verbindungen, die in anderen Mandanten konfiguriert wurden, werden ebenfalls angezeigt
4. Klicken Sie auf **\[M]** um eine neue Verbindung herzustellen

   ▷ Die [↗ „RESTful-Verbindung konfigurieren“](/collection/german/pflichtbasis/platform-core/connect-hub/connectivity-as-a-service/connect-devices-via-restful/configure-restful-connection.md) Fenster öffnet sich

Weiter im Kapitel [↗ „RESTful-Verbindung konfigurieren“](/collection/german/pflichtbasis/platform-core/connect-hub/connectivity-as-a-service/...with-kafka/configure-connection.md)

## Vorhandene Verbindung bearbeiten

1. Klicken Sie in der Seitenleiste auf **Verbindung \[A]**

   ▷ Das Fenster "Verbindungen" öffnet sich
2. Wählen Sie den **RESTful \[B]** Tab
3. Im Arbeitsbereich **\[C]**, eine Liste der bereits vorhandenen Verbindungen **\[D]** angezeigt

   ◈ Wenn Sie keine Einträge sehen, sind noch keine Verbindungen vorhanden

   ◈ Verbindungen, die in anderen Mandanten konfiguriert wurden, werden ebenfalls angezeigt
4. Klicken Sie auf **\[M]** um eine neue Verbindung herzustellen

   ▷ Die [↗ „RESTful-Verbindung konfigurieren“](/collection/german/pflichtbasis/platform-core/connect-hub/connectivity-as-a-service/connect-devices-via-restful/configure-restful-connection.md) Fenster öffnet sich

Weiter im Kapitel [↗ „RESTful-Verbindung konfigurieren“](/collection/german/pflichtbasis/platform-core/connect-hub/connectivity-as-a-service/connect-devices-via-restful/configure-restful-connection.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.buildings.ability.abb/collection/german/pflichtbasis/platform-core/connect-hub/connectivity-as-a-service/connect-devices-via-restful.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.