{"id":10570,"date":"2023-08-11T10:24:50","date_gmt":"2023-08-11T08:24:50","guid":{"rendered":"https:\/\/www.virtenio.com\/?post_type=avada_portfolio&#038;p=10570"},"modified":"2026-11-12T19:15:54","modified_gmt":"2026-11-12T18:15:54","slug":"der-nutzen-der-restful-api-und-webhooks-optimiertes-raumklima-management-mit-der-hlk-ampel","status":"publish","type":"avada_portfolio","link":"https:\/\/www.virtenio.com\/de\/portfolio-items\/der-nutzen-der-restful-api-und-webhooks-optimiertes-raumklima-management-mit-der-hlk-ampel\/","title":{"rendered":"REST-API &#038; Webhooks: Raumklima integrieren"},"content":{"rendered":"<div class=\"fusion-fullwidth fullwidth-box fusion-builder-row-1 fusion-flex-container nonhundred-percent-fullwidth non-hundred-percent-height-scrolling gw07-body gwc gwa gwa-10570\" style=\"--awb-border-radius-top-left:0px;--awb-border-radius-top-right:0px;--awb-border-radius-bottom-right:0px;--awb-border-radius-bottom-left:0px;--awb-padding-top:0px;--awb-padding-right:0px;--awb-padding-bottom:0px;--awb-padding-left:0px;--awb-flex-wrap:wrap;\" ><div class=\"fusion-builder-row fusion-row fusion-flex-align-items-flex-start fusion-flex-content-wrap\" style=\"max-width:calc( 1200px + 0px );margin-left: calc(-0px \/ 2 );margin-right: calc(-0px \/ 2 );\"><div class=\"fusion-layout-column fusion_builder_column fusion-builder-column-0 fusion_builder_column_1_1 1_1 fusion-flex-column gwc-content\" style=\"--awb-bg-size:cover;--awb-width-large:100%;--awb-margin-top-large:0px;--awb-spacing-right-large:0px;--awb-margin-bottom-large:0px;--awb-spacing-left-large:0px;--awb-width-medium:100%;--awb-spacing-right-medium:0px;--awb-spacing-left-medium:0px;--awb-width-small:100%;--awb-spacing-right-small:0px;--awb-spacing-left-small:0px;\"><div class=\"fusion-column-wrapper fusion-flex-justify-content-flex-start fusion-content-layout-column\"><div class=\"fusion-text fusion-text-1 gw07-takeaways\" style=\"--awb-font-size:17px;--awb-line-height:1.8;--awb-letter-spacing:0px;--awb-text-color:#5f5f5f;\"><p><strong><\/strong><\/p>\n<ul>\n<li>Lokale Assistenz und digitale Weitergabe erg\u00e4nzen sich.<\/li>\n<li>REST-API liefert Daten aus der VIRTENIO Cloud; Webhooks melden dort konfigurierte Ereignisse.<\/li>\n<li>Ein klarer Empf\u00e4nger und eine geplante Reaktion machen aus Daten einen hilfreichen Ablauf.<\/li>\n<\/ul>\n<\/div><div class=\"fusion-title title fusion-title-1 fusion-sep-none fusion-title-text fusion-title-size-two gw07-section-title\" style=\"--awb-text-color:#003778;--awb-margin-bottom:18px;--awb-margin-top-small:0px;--awb-margin-right-small:0px;--awb-margin-bottom-small:20px;--awb-margin-left-small:0px;--awb-font-size:29px;\" id=\"zusammenhang\"><h2 class=\"fusion-title-heading title-heading-left fusion-responsive-typography-calculated\" style=\"margin:0;font-size:1em;--fontSize:29;line-height:1.25;\">REST-API und Webhooks: zwei Wege \u00fcber die Cloud<\/h2><\/div><div class=\"fusion-text fusion-text-2 gw07-article-text\" style=\"--awb-font-size:17px;--awb-line-height:1.8;--awb-letter-spacing:0px;--awb-text-color:#5f5f5f;\"><p>Vor Ort macht die Ampel Handlungsbedarf sichtbar. F\u00fcr ein Geb\u00e4udeteam mit vielen R\u00e4umen ist zus\u00e4tzlich wichtig, Daten am eigenen Arbeitsplatz nutzen zu k\u00f6nnen. Die dokumentierte REST-API greift auf die VIRTENIO Cloud-Plattform zu. Eine eigene Anwendung kann aktuelle oder historische Messdaten und Systemzust\u00e4nde abrufen und beispielsweise einem Raum-Dashboard zuordnen.<\/p>\n<p>Damit entf\u00e4llt das manuelle Sammeln einzelner Messwerte. Die lokale HLK-Empfehlung bleibt eine eigenst\u00e4ndige Assistenzleistung: Die HLK Ampel bewertet CO\u2082, Temperatur und Feuchte gemeinsam; die Schnittstelle erweitert die Nutzung der verf\u00fcgbaren Daten im eigenen Prozess.<\/p>\n<p>F\u00fcr die API-Nutzung werden die dokumentierte Cloud-Option, WLAN\/Internet und passende Zugriffsrechte eingerichtet. Ein gesch\u00fctzter Abruf nutzt ein API-Token. Abrufrhythmus und Verarbeitung legt die eigene Anwendung fest; die hier beschriebene REST-API ist keine direkte lokale Ger\u00e4te-API.<sup class=\"gwc-citation\"><a href=\"#quelle-1\">1<\/a><\/sup><\/p>\n<\/div><div class=\"fusion-title title fusion-title-2 fusion-sep-none fusion-title-text fusion-title-size-three gw07-section-title\" style=\"--awb-text-color:#003778;--awb-margin-bottom:18px;--awb-margin-top-small:0px;--awb-margin-right-small:0px;--awb-margin-bottom-small:20px;--awb-margin-left-small:0px;--awb-font-size:29px;\" id=\"erkennen\"><h3 class=\"fusion-title-heading title-heading-left fusion-responsive-typography-calculated\" style=\"margin:0;font-size:1em;--fontSize:29;line-height:1.25;\">Webhooks: Ereignisse melden statt regelm\u00e4\u00dfig abfragen<\/h3><\/div><div class=\"fusion-text fusion-text-3 gw07-article-text\" style=\"--awb-font-size:17px;--awb-line-height:1.8;--awb-letter-spacing:0px;--awb-text-color:#5f5f5f;\"><p>Ohne Ereignismeldung m\u00fcsste eine Anwendung regelm\u00e4\u00dfig nachfragen oder ein Verantwortlicher die Anzeige verfolgen. Ein Webhook \u00fcbermittelt bei einem definierten Cloud-Ereignis eine Meldung an den eingerichteten Empf\u00e4nger. Regeln k\u00f6nnen CO\u2082, Temperatur oder relative Feuchte sowie \u00dcber- oder Unterschreitungen ber\u00fccksichtigen. Eine Hysterese hilft, unn\u00f6tig h\u00e4ufige Meldungen bei schwankenden Werten zu begrenzen.<\/p>\n<p>Der praktische Nutzen liegt in der Weitergabe an die richtige Stelle: Ein Raumzustand wird im Geb\u00e4udemanagement sichtbar oder ein zust\u00e4ndiges Team kann informiert werden. Eine solche Cloud-Regel ist gesondert konfiguriert; sie ist nicht automatisch eine identische Kopie der gesamten HLK-Empfehlungslogik.<sup class=\"gwc-citation\"><a href=\"#quelle-2\">2<\/a><\/sup><\/p>\n<\/div><figure data-gw-illustration=\"gwa-sequence-10570\" style=\"box-sizing:border-box;container-type:inline-size;width:100%;max-width:36rem;margin:18px auto 0;align-self:center;padding:0;text-align:center;font:16px\/1.45 Roboto,Arial,Helvetica,sans-serif;letter-spacing:normal;color:#003778;text-wrap:balance\"><div style=\"font-size:clamp(16px,3.222cqi,18px);color:#003778;font-weight:700;line-height:1.3;text-align:left\">Zwei Wege. Eine Cloud-Anbindung.<\/div><svg viewBox=\"0 90 900 594\" role=\"img\" aria-label=\"Nachrichtenrichtungen zwischen eigener Anwendung und VIRTENIO Cloud: REST-API fragt Daten ab, Webhook \u00fcbermittelt eine Regelmeldung.\" style=\"display:block;width:100%;height:auto;margin:0;border:0;margin-top:4.367%\"><rect width=\"900\" height=\"684\" fill=\"#fff\"\/><g transform=\"translate(0 24)\"><rect x=\"55\" y=\"73\" width=\"330\" height=\"65\" rx=\"9\" fill=\"#003778\" stroke=\"none\"\/><text x=\"220\" y=\"115\" font-family=\"Helvetica,Arial,sans-serif\" font-size=\"27\" font-weight=\"bold\" fill=\"#fff\" stroke=\"none\" text-anchor=\"middle\">Eigene Anwendung<\/text><path d=\"M220 145L220 540\" fill=\"none\" stroke=\"#c7d8e2\" stroke-width=\"2\" stroke-dasharray=\"5 8\"\/><rect x=\"515\" y=\"73\" width=\"330\" height=\"65\" rx=\"9\" fill=\"#003778\" stroke=\"none\"\/><text x=\"680\" y=\"115\" font-family=\"Helvetica,Arial,sans-serif\" font-size=\"27\" font-weight=\"bold\" fill=\"#fff\" stroke=\"none\" text-anchor=\"middle\">VIRTENIO Cloud<\/text><path d=\"M680 145L680 540\" fill=\"none\" stroke=\"#c7d8e2\" stroke-width=\"2\" stroke-dasharray=\"5 8\"\/><text x=\"36\" y=\"207\" font-family=\"Helvetica,Arial,sans-serif\" font-size=\"25\" font-weight=\"bold\" fill=\"#5D9B39\" stroke=\"none\" text-anchor=\"start\">REST-API<\/text><g fill=\"none\" stroke=\"#00AFE2\" stroke-width=\"3\"><path d=\"M235 247L665 247\"\/><path d=\"M655 239L665 247L655 255\"\/><\/g><text x=\"450\" y=\"232\" font-family=\"Helvetica,Arial,sans-serif\" font-size=\"26\" font-weight=\"normal\" fill=\"#003778\" stroke=\"none\" text-anchor=\"middle\">Daten gezielt anfragen<\/text><g fill=\"none\" stroke=\"#003778\" stroke-width=\"3\"><path d=\"M665 303L235 303\"\/><path d=\"M245 295l-10 8 10 8\"\/><\/g><text x=\"450\" y=\"345\" font-family=\"Helvetica,Arial,sans-serif\" font-size=\"26\" font-weight=\"normal\" fill=\"#003778\" stroke=\"none\" text-anchor=\"middle\">Daten zur\u00fcckgeben<\/text><text x=\"36\" y=\"414\" font-family=\"Helvetica,Arial,sans-serif\" font-size=\"25\" font-weight=\"bold\" fill=\"#5D9B39\" stroke=\"none\" text-anchor=\"start\">WEBHOOK<\/text><circle cx=\"680\" cy=\"452\" r=\"11\" fill=\"#5D9B39\" stroke=\"none\"\/><g fill=\"none\" stroke=\"#5D9B39\" stroke-width=\"3\"><path d=\"M665 452L235 452\"\/><path d=\"M245 444l-10 8 10 8\"\/><\/g><text x=\"450\" y=\"499\" font-family=\"Helvetica,Arial,sans-serif\" font-size=\"26\" font-weight=\"normal\" fill=\"#003778\" stroke=\"none\" text-anchor=\"middle\">Regel trifft zu \u2192 Meldung senden<\/text><rect x=\"35\" y=\"564\" width=\"830\" height=\"65\" rx=\"7\" fill=\"#f2f7fa\" stroke=\"none\"\/><text x=\"450\" y=\"605\" font-family=\"Helvetica,Arial,sans-serif\" font-size=\"26\" font-weight=\"normal\" fill=\"#455d70\" stroke=\"none\" text-anchor=\"middle\">Voraussetzung: passende gebuchte Cloud-Option<\/text><\/g><\/svg><\/figure><div class=\"fusion-text fusion-text-4 gwc-caption gwa-figure-caption\" style=\"--awb-font-size:13px;--awb-line-height:1.6;--awb-letter-spacing:0px;--awb-text-color:#627680;\"><p style=\"text-align:center;font-size:13px;max-width:72ch;margin-inline:auto;text-wrap:balance\">REST-API: gezielter Abruf. Webhook: Meldung durch eine konfigurierte Cloud-Regel.<\/p>\n<\/div><div class=\"fusion-title title fusion-title-3 fusion-sep-none fusion-title-text fusion-title-size-three gw07-section-title\" style=\"--awb-text-color:#003778;--awb-margin-bottom:18px;--awb-margin-top-small:0px;--awb-margin-right-small:0px;--awb-margin-bottom-small:20px;--awb-margin-left-small:0px;--awb-font-size:29px;\" id=\"vertiefung-1\"><h3 class=\"fusion-title-heading title-heading-left fusion-responsive-typography-calculated\" style=\"margin:0;font-size:1em;--fontSize:29;line-height:1.25;\">Eine Integration vom gew\u00fcnschten Ablauf her planen<\/h3><\/div><div class=\"fusion-text fusion-text-5 gw07-article-text\" style=\"--awb-font-size:17px;--awb-line-height:1.8;--awb-letter-spacing:0px;--awb-text-color:#5f5f5f;\"><p>Beginnen Sie mit dem gew\u00fcnschten Ergebnis: Messwerte in der eigenen Oberfl\u00e4che, ein Hinweis f\u00fcr das Geb\u00e4udeteam oder eine geplante Folgereaktion. W\u00e4hrend die Menschen vor Ort bereits von der Ampel unterst\u00fctzt werden, kann die Integration den Informationsweg \u00fcber Raumgrenzen hinweg verk\u00fcrzen.<\/p>\n<p>F\u00fcr eine Folgereaktion werden Empf\u00e4ngerformat, Zugriffsrechte und Zust\u00e4ndigkeit festgelegt. Soll eine Anlage automatisch schalten, braucht es zus\u00e4tzlich eine geeignete, gepr\u00fcfte Umsetzung im Zielsystem. Auch der Umgang mit ausbleibenden Meldungen wird dort definiert.<\/p>\n<\/div><div class=\"fusion-title title fusion-title-4 fusion-sep-none fusion-title-text fusion-title-size-two gw07-section-title\" style=\"--awb-text-color:#003778;--awb-margin-bottom:18px;--awb-margin-top-small:0px;--awb-margin-right-small:0px;--awb-margin-bottom-small:20px;--awb-margin-left-small:0px;--awb-font-size:29px;\" id=\"praxis\"><h2 class=\"fusion-title-heading title-heading-left fusion-responsive-typography-calculated\" style=\"margin:0;font-size:1em;--fontSize:29;line-height:1.25;\">Ein Hinweis f\u00fcr das Geb\u00e4udeteam<\/h2><\/div><div class=\"fusion-text fusion-text-6 gw07-article-text gwa-practice-plain\" style=\"--awb-font-size:17px;--awb-line-height:1.8;--awb-letter-spacing:0px;--awb-text-color:#5f5f5f;\"><p>Beispiel: Eine Einrichtung betreut mehrere Schulungsr\u00e4ume. Die Cloud-Regel meldet eine vereinbarte Auff\u00e4lligkeit an einen eigenen Dienst, der sie dem zust\u00e4ndigen Geb\u00e4udeteam mit Raumzuordnung bereitstellt. Vor Ort bleibt die Ampel f\u00fcr die Nutzer sichtbar.<\/p>\n<p>Damit muss niemand s\u00e4mtliche Messwertansichten st\u00e4ndig offen halten. Die lokale Assistenz erleichtert das unmittelbare Handeln; die digitale Meldung hilft, wiederkehrende oder organisatorisch relevante Situationen an die richtige Stelle zu bringen.<\/p>\n<\/div><div class=\"fusion-title title fusion-title-5 fusion-sep-none fusion-title-text fusion-title-size-two gw07-section-title\" style=\"--awb-text-color:#003778;--awb-margin-bottom:18px;--awb-margin-top-small:0px;--awb-margin-right-small:0px;--awb-margin-bottom-small:20px;--awb-margin-left-small:0px;--awb-font-size:29px;\" id=\"anwenden\"><h2 class=\"fusion-title-heading title-heading-left fusion-responsive-typography-calculated\" style=\"margin:0;font-size:1em;--fontSize:29;line-height:1.25;\">Eine gute Schnittstellenanfrage enth\u00e4lt f\u00fcnf Angaben<\/h2><\/div><div class=\"fusion-text fusion-text-7 gw07-article-text\" style=\"--awb-font-size:17px;--awb-line-height:1.8;--awb-letter-spacing:0px;--awb-text-color:#5f5f5f;\"><ul>\n<li>Zielsystem und verantwortliche IT-Ansprechperson.<\/li>\n<li>Ben\u00f6tigte Messgr\u00f6\u00dfen, R\u00e4ume und Zeitraum.<\/li>\n<li>Regelm\u00e4\u00dfiger Datenabruf oder ereignisbezogene Meldung.<\/li>\n<li>Geplante Reaktion, Zugriffsrechte und Empf\u00e4ngerformat.<\/li>\n<li>Umgang mit fehlender Verbindung und ausbleibenden Meldungen.<\/li>\n<\/ul>\n<p>Mit dieser Beschreibung l\u00e4sst sich pr\u00fcfen, welche vorhandenen VIRTENIO-Funktionen passen und welche Arbeit im Zielsystem erforderlich ist. Die lokale Webansicht ist dabei ein anderer Zugang als die hier beschriebene Cloud-REST-API.<sup class=\"gwc-citation\"><a href=\"#quelle-1\">1<\/a>, <a href=\"#quelle-2\">2<\/a><\/sup><\/p>\n<\/div><div class=\"fusion-title title fusion-title-6 fusion-sep-none fusion-title-text fusion-title-size-two gw07-section-title\" style=\"--awb-text-color:#003778;--awb-margin-bottom:18px;--awb-margin-top-small:0px;--awb-margin-right-small:0px;--awb-margin-bottom-small:20px;--awb-margin-left-small:0px;--awb-font-size:29px;\" id=\"quellen\"><h2 class=\"fusion-title-heading title-heading-left fusion-responsive-typography-calculated\" style=\"margin:0;font-size:1em;--fontSize:29;line-height:1.25;\">Quellen und Vertiefung<\/h2><\/div><div class=\"fusion-text fusion-text-8 gwc-sources\" style=\"--awb-font-size:17px;--awb-line-height:1.8;--awb-letter-spacing:0px;--awb-text-color:#5f5f5f;\"><ol class=\"gwc-source-list\">\n<li id=\"quelle-1\"><a href=\"https:\/\/www.virtenio.com\/wp-content\/uploads\/2023\/08\/Benutzerhandbuch_PreonCube_HLK_Ampel.pdf#page=72\">VIRTENIO: REST-API: HLK-Handbuch, Kapitel 7.7<\/a><span>Cloudbasierter API-Zugriff, Bucket-ID, Daten und Autorisierung; kein direkter Zugriff auf das Ger\u00e4t.<\/span><\/li>\n<li id=\"quelle-2\"><a href=\"https:\/\/www.virtenio.com\/wp-content\/uploads\/2023\/08\/Benutzerhandbuch_PreonCube_HLK_Ampel.pdf#page=80\">VIRTENIO: Webhooks: HLK-Handbuch, Kapitel 7.10<\/a><span>Cloud-Regeln, Messgr\u00f6\u00dfen, Schwellwerte, Hysterese und \u00dcbergabeformate.<\/span><\/li>\n<\/ol>\n<\/div><\/div><\/div><\/div><\/div>\n","protected":false},"excerpt":{"rendered":"<p>Raumklima-Daten ohne manuelles Sammeln weiterverwenden: REST-API und Webhooks erg\u00e4nzen die lokale Assistenz der Ampel. Erfahren Sie, wie Daten aus der VIRTENIO Cloud in eigene Anwendungen gelangen und konfigurierte Ereignisse zust\u00e4ndige Teams erreichen k\u00f6nnen.<\/p>\n","protected":false},"author":3,"featured_media":13211,"menu_order":4,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"virtenio_gw_intro":"Die Ampel unterst\u00fctzt Menschen direkt im Raum. \u00dcber REST-API und Webhooks k\u00f6nnen zus\u00e4tzlich eigene Anwendungen und zust\u00e4ndige Teams Raumklima-Daten nutzen. So m\u00fcssen Verantwortliche nicht jeden Raum selbst aufsuchen oder Messwerte manuell \u00fcbertragen.","virtenio_gw_product":"hlk","virtenio_gw_related_ids":"10559,10575,12875","virtenio_gw_module":"1","virtenio_gw_role":"article","virtenio_gw_product_title":"Ihre Integrationsidee technisch konkretisieren","virtenio_gw_product_text":"<p>Welche Information soll in Ihrem System ankommen \u2013 und wer soll darauf reagieren? Wir kl\u00e4ren Datenzugang, Cloud-Option und einen \u00fcberschaubaren Integrationsfall passend zu Ihrer IT und Ihrem Geb\u00e4udebetrieb.<\/p>","virtenio_gw_product_button":"","virtenio_gw_featured_id":"","footnotes":""},"portfolio_category":[234,148],"portfolio_skills":[],"portfolio_tags":[157,160,159,126,156,134,154,158,161,155],"class_list":["post-10570","avada_portfolio","type-avada_portfolio","status-publish","format-standard","has-post-thumbnail","hentry","portfolio_category-gw07-technik","portfolio_category-technisches","portfolio_tags-anpassung","portfolio_tags-automatisierung","portfolio_tags-echtzeit-updates","portfolio_tags-hlk-ampel","portfolio_tags-interoperabilitaet","portfolio_tags-raumklima-management","portfolio_tags-restful-api","portfolio_tags-skalierbarkeit","portfolio_tags-vernetzte-welt","portfolio_tags-webhooks"],"_links":{"self":[{"href":"https:\/\/www.virtenio.com\/de\/wp-json\/wp\/v2\/avada_portfolio\/10570","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.virtenio.com\/de\/wp-json\/wp\/v2\/avada_portfolio"}],"about":[{"href":"https:\/\/www.virtenio.com\/de\/wp-json\/wp\/v2\/types\/avada_portfolio"}],"author":[{"embeddable":true,"href":"https:\/\/www.virtenio.com\/de\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/www.virtenio.com\/de\/wp-json\/wp\/v2\/comments?post=10570"}],"version-history":[{"count":16,"href":"https:\/\/www.virtenio.com\/de\/wp-json\/wp\/v2\/avada_portfolio\/10570\/revisions"}],"predecessor-version":[{"id":13305,"href":"https:\/\/www.virtenio.com\/de\/wp-json\/wp\/v2\/avada_portfolio\/10570\/revisions\/13305"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.virtenio.com\/de\/wp-json\/wp\/v2\/media\/13211"}],"wp:attachment":[{"href":"https:\/\/www.virtenio.com\/de\/wp-json\/wp\/v2\/media?parent=10570"}],"wp:term":[{"taxonomy":"portfolio_category","embeddable":true,"href":"https:\/\/www.virtenio.com\/de\/wp-json\/wp\/v2\/portfolio_category?post=10570"},{"taxonomy":"portfolio_skills","embeddable":true,"href":"https:\/\/www.virtenio.com\/de\/wp-json\/wp\/v2\/portfolio_skills?post=10570"},{"taxonomy":"portfolio_tags","embeddable":true,"href":"https:\/\/www.virtenio.com\/de\/wp-json\/wp\/v2\/portfolio_tags?post=10570"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}