Flexibler Datenaustausch
Einführung
Der flexible Datenaustausch ist die empfohlene HTTP-Integrationsmethode, wenn es nicht möglich ist, das vom Gerät gesendete Datenformat zu ändern.
Der flexible Datenaustausch unterstützt nur Uplink-Nachrichten. Uplink-Nachrichten sind alle Nachrichten, die von Geräten an die Plattform gesendet werden. Die Plattform muss in der Lage sein, Uplink-Nachrichten zu verarbeiten, um die relevanten Informationen zu speichern und zu verarbeiten. Dies wird durch Scripting erreicht, um den Nachrichteninhalt zu interpretieren und die Informationen auf der Plattform zu speichern.
Es ist nicht möglich, Downlink-Nachrichten (d. h. von der Plattform zum Gerät) über den flexiblen HTTP-Datenaustausch zu senden.
Zu befolgende Schritte
Konfiguration der Daten-Upload-URL
Damit die Plattform Gerätedaten empfangen kann, müssen Sie das Gerät so konfigurieren, dass es HTTP-Nachrichten per POST an die folgende URL sendet:
https://gear.cloud.studio/api/v2/uplink/{DeviceAddress}Dabei gilt:
- DeviceAddress ist die Geräte-Adresse, wie sie beim Erstellen des Geräts auf der Plattform eingegeben wurde.
Wenn die Geräte-Adresse beispielsweise 06A022B39C14 lautet, sollte das Gerät so konfiguriert werden, dass es per POST an die folgende URL sendet:
https://gear.cloud.studio/api/v2/uplink/06A022B39C14Konfiguration des Zugriffstokens
Das Zugriffstoken muss ebenfalls als Teil des Headers gesendet werden, unter Verwendung eines Authorization-Headers, wie unten dargestellt:
Authorization: Bearer e54e0911-ece3-4b7a-b84d-afc01dfa81f1Alternativ kann das Zugriffstoken, wenn es nicht möglich ist, das Token über den Authorization-Header zu senden, als Teil der URL über den Parameter "accessToken" gesendet werden, wie im folgenden Beispiel:
https://gear.cloud.studio/api/v2/uplink/06A022B39C14?accessToken=e54e0911-ece3-4b7a-b84d-afc01dfa81f1Sobald diese Schritte abgeschlossen sind, beginnt die Plattform mit dem Empfang und der Verarbeitung von Geräteinformationen. Wenn das Gerät ein Modell verwendet, das von der Plattform nicht nativ unterstützt wird, müssen Sie auch die Datenverarbeitungsskripte definieren, wie in diesem Abschnitt beschrieben.
HTTP
Einführung Dieser Abschnitt beschreibt die Integration mit der Gear Studio-Plattform über HTTP. Diese Funktionalität ermöglicht die Integration von Geräten verschiedener Hersteller sowie selbstgebauten Geräten mit Arduino, nodeMCU, Raspberry Pi und jeder anderen Plattform, die HTTP-Kommunikation unterstützt.
HTTP API
Einführung HTTP API: Die HTTP API ermöglicht es Geräten, mit der Plattform über ein spezifisches Nachrichtenformat zu kommunizieren, das in den folgenden Abschnitten dokumentiert ist und Folgendes ermöglicht...