Feature

Analysis Endpoints sind da

Geben Sie einer Luau-Analysis eine HTTP-URL für Formulare, Webhooks, Gerätekonfigurationen und Antworten, die Ihre Dashboards verwenden können.

TagoIO Team ·
Analysis Endpoints sind da

Eine Analysis kann Ihre Daten bereits verarbeiten. Mit Analysis Endpoints kann sie auch der Anwendung antworten, die sie aufgerufen hat. Geben Sie einer Luau-Analysis eine eigene HTTP-URL, senden Sie eine Anfrage und erhalten Sie das Skriptergebnis mit demselben Aufruf zurück.

Ein Dashboard-Formular kann vor dem Speichern prüfen lassen, ob eine Temperatureinstellung gültig ist. Ein Gerät kann seine Konfiguration abrufen, oder ein anderer Dienst kann einen Webhook senden und eine Bestätigung erhalten. Diese Logik für Anfragen und Antworten bleibt in TagoIO, direkt bei Ihren Gerätedaten und Zugriffsregeln. Sie müssen keinen separaten Webdienst bereitstellen.

Ihre Analysis mit eigener URL

Eine Luau-Analysis mit eigener HTTP-URL, den Zugriffsoptionen Public oder Token und Antworten als JSON, CSV, HTML oder Weiterleitung

Geben Sie JSON an ein Gerät zurück, senden Sie einen CSV-Export an eine Tabellenkalkulation oder liefern Sie eine HTML-Seite aus. Ihr Skript bestimmt die Antwort, einschließlich Weiterleitungen.

Verwenden Sie Public für Anfragen ohne Token oder Token für authentifizierte Aufrufer. Access Management steuert, welche Run-Benutzer und Analyses Ihren Code aufrufen dürfen. Ihr Skript kann anhand der Identität des Aufrufers entscheiden, was es zurückgibt.

Die Antwort direkt im Dashboard anzeigen

Ein Dashboard-Sollwert von 50 °C wird abgelehnt: Die Analysis gibt einen Feldfehler zurück, das Formular zeigt den zulässigen Bereich von 5 bis 30, und es wird nichts gespeichert

Custom Dashboards im Admin und in TagoRUN rufen Endpoints mit der Sitzung des Betrachters auf. Im HTML des Dashboards muss kein Token hinterlegt werden.

Lehnen Sie eine Thermostateinstellung außerhalb des zulässigen Bereichs ab und zeigen Sie den Fehler neben dem Feld an, bevor etwas gespeichert wird. Das Beispiel zur Formularvalidierung im Dashboard zeigt, wie Sie das Formular mit Ihrer Analysis verbinden.

Webhooks empfangen und Middleware erstellen

Ein Wetterdienst sendet 23,5 °C und 64 % Luftfeuchtigkeit an eine Luau-Analysis, die die Eingabe validiert, die Temperatur in 74,3 °F umrechnet, die Messwerte speichert und im selben Aufruf eine Bestätigung zurückgibt

Empfangen Sie Ereignisse aus externen Systemen, ohne einen Webhook-Server bereitzustellen. Ein Wetterdienst kann beispielsweise Temperatur und Luftfeuchtigkeit in einer einzigen Anfrage senden. Ihre Analysis kann die Messwerte validieren, Celsius in Fahrenheit umrechnen, die Ergebnisse beim passenden Gerät speichern und eine Bestätigung zurückgeben.

Verwenden Sie einen Endpoint als Middleware, wenn eine andere Anwendung ein abweichendes Datenformat sendet oder eine bestimmte Antwort erwartet. Ihr Skript kann die Eingabe validieren und umwandeln, mit TagoIO-Ressourcen arbeiten und das Format zurückgeben, das die Anwendung benötigt. Das Webhook-Beispiel enthält einen vollständigen Empfänger.

Ein Formular veröffentlichen, ohne eine Website zu hosten

Ein von einem Endpoint bereitgestelltes Feedback-Formular sendet eine Nachricht, speichert sie in den Gerätedaten und erhält eine Dankesseite zurück

Ein Endpoint kann ein HTML-Formular ausliefern, die übermittelten Eingaben annehmen, die Daten speichern und eine Dankesseite zurückgeben. Das Beispiel für ein Feedback-Formular enthält alles, was Sie dafür benötigen.

Weitere Beispiele zeigen, wie Sie Gerätekonfigurationen bereitstellen und Messwerte als CSV exportieren.

Im Admin entwickeln und testen

Try it im Admin sendet eine JSON-Anfrage an /orders und zeigt eine Antwort mit 200 OK an, die den Anfrageinhalt zurückgibt

Testen Sie Anfragen im Admin und prüfen Sie die Antwort, die Ihre Anwendung erhalten wird, bevor Sie sie anbinden. TagoAI kann Ihnen helfen, das Luau-Skript zu schreiben und seinen Endpoint zu aktivieren.

Erste Schritte

Analysis Endpoints sind in jedem Tarif verfügbar. Luau-Ausführungen werden nicht auf Ihr Analysis Service-Limit angerechnet; für Geräte- und andere Ressourcenoperationen gelten weiterhin die üblichen Limits.

Berücksichtigen Sie die Limits für Aufrufe und Payloads, wenn Sie Ihre Anwendung planen.

Lesen Sie die Anleitung zu Analysis Endpoints und öffnen Sie dann eine Luau-Analysis im Admin, um Ihren Endpoint zu aktivieren.