> 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/verpflichtende-basis/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 abzufragen *Ressourcen*. Ein *Ressource* kann alles sein, das 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, in der Regel als .json oder .xml.

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

## Was ist der Unterschied zwischen RESTful und Webhook?

Der wichtigste Unterschied ist die Kommunikationsrichtung.

* Bei RESTful sendet ein Client Anfragen an einen Server. Der Server antwortet mit einem Statuscode und (falls 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 Daten aktiv in Echtzeit an den Client. Der Client muss keine Anfragen senden. Für die Kommunikation über Webhooks muss der Server die Adresse des Clients kennen.

## Vorgehensweise

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. Die einzelnen Parameter, die abgefragt werden sollen, werden in diese Anfragen eingetragen.

<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>

## Überblick

<figure><img src="https://2215908449-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOqGnkz52o2zVUsEGEZGk%2Fuploads%2FBPXoshRYURjgf28uHfJi%2FGroup%2018.png?alt=media&amp;token=9f22b029-9522-4977-ad38-c6ba71ffc748" alt=""><figcaption><p>Abb. 1 – Verbindungen RESTful</p></figcaption></figure>

<figure><img src="https://2215908449-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOqGnkz52o2zVUsEGEZGk%2Fuploads%2FTfVbqaTls9Y5sfj5l81T%2FGroup%20568.png?alt=media&amp;token=6e3637e7-3b83-43b2-8593-3c4cd048d82f" alt=""><figcaption><p>Abb. 2 – Verbindungen RESTful (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 zugewiesen 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. ⚠ Achtung: 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 die **RESTful \[B]** Registerkarte
3. Im Arbeitsbereich **\[C]**, eine Liste der bereits vorhandenen Verbindungen **\[D]** wird 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/verpflichtende-basis/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/verpflichtende-basis/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 die **RESTful \[B]** Registerkarte
3. Im Arbeitsbereich **\[C]**, eine Liste der bereits vorhandenen Verbindungen **\[D]** wird 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/verpflichtende-basis/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/verpflichtende-basis/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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.